# Connect Claude or ChatGPT to your brand guidelines.

Canonical: https://jinn.works/what-jinn-can-do/agents/docs

[Jinn.](https://jinn.works/)

- [Sign In](https://jinn.works/login)

[Get Started](https://jinn.works/get-started)

- [What Jinn Can Do](https://jinn.works/what-jinn-can-do)

[Jinn Platform, brain and Brand DNA Record](https://jinn.works/how-it-works)

[Writing Writes posts, long pieces and replies in your voice, checks every draft, and publishes only after you approve.](https://jinn.works/what-jinn-can-do/writing)

[Visibility Asks ChatGPT, Perplexity, Claude, Gemini, Grok and Google AI Overviews what they say about your brand, scores the answers, and hands over the fixes.](https://jinn.works/what-jinn-can-do/visibility)

[Images Creates product images and ads from your record, with your real product cut out before anything renders.](https://jinn.works/what-jinn-can-do/images)

[Video Video cast from your brand: research, scripts and a cast of characters today, with a person approving each stage.](https://jinn.works/what-jinn-can-do/video)

[Strategy Strategy with receipts: reads your record and the market, writes the plan, and shows the sources behind it.](https://jinn.works/what-jinn-can-do/strategy)

[Agents Any AI agent signs in with Jinn and reads your brand's record.](https://jinn.works/what-jinn-can-do/agents)

[Campaigns The Jinn team turns one winning ad into a whole campaign: social posts, landing pages and emails, as drafts that wait for your yes.](https://jinn.works/what-jinn-can-do/campaigns)

[All Features, One Record](https://jinn.works/what-jinn-can-do)

- [Who It Helps](https://jinn.works/for)

[For E-commerce Brands Scale your marketing output, and test your creative before putting your budget to work.](https://jinn.works/for/ecommerce)

[For Agencies Many client brands, one record each.](https://jinn.works/for/agencies)

[For Marketing Teams Marketing teams are asked for more than their headcount can make.](https://jinn.works/for/marketing-teams)

[For Startups & SMBs One brand, a small crew, a bigger body of work.](https://jinn.works/for/smb)

[For Individuals Grow your personal brand to grow your audience.](https://jinn.works/for/individuals)

[For AI Agents When a buyer's agent reads your brand.](https://jinn.works/for/agents)

[Let's Talk](https://jinn.works/contact)

- [How It Works](https://jinn.works/how-it-works)

[The Brand Record What Jinn knows about your brand, and where each fact came from.](https://jinn.works/how-it-works/schema)

[What "Verified" Means Who confirms a fact, and what each fact carries.](https://jinn.works/how-it-works/verified)

[Guards and Spend The checks on your money and your name.](https://jinn.works/how-it-works/guards)

[Models Which kind of model does which job.](https://jinn.works/how-it-works/models)

[Measurement How results are scored, the same way every time.](https://jinn.works/how-it-works/measurement)

[Your Data Who can see it, how long it is kept, how to delete it.](https://jinn.works/how-it-works/your-data)

[See the Whole Loop](https://jinn.works/how-it-works)

- [Uwee U](https://jinn.works/uwee-u)

[Learn Jinn Short lessons on the loop and the record.](https://jinn.works/uwee-u/learn)

[Guides and Docs MCP guides and feature docs.](https://jinn.works/uwee-u/guides)

[Research The AI Brand Index and studies.](https://jinn.works/uwee-u/research)

[Thinking What we're building, learning and sharing.](https://jinn.works/blog)

[Release Notes New features, week by week.](https://jinn.works/uwee-u/release-notes)

[Open Uwee U](https://jinn.works/uwee-u)

- [Meet the Uwees](https://jinn.works/uwees)

[Biscuit Chief Customer Companion](https://jinn.works/uwees#biscuit)

[Pip Director of Keeping the Record Straight](https://jinn.works/uwees#bram)

[Bristle Brand Visionary](https://jinn.works/uwees#bristle)

[Luna Chief Research Librarian](https://jinn.works/uwees#clipping)

[Filler Missing-Facts Editor](https://jinn.works/uwees#filler)

[Fold Rules Editor (The Learner)](https://jinn.works/uwees#fold)

[Murmur Director of Sounding Like Your Brand](https://jinn.works/uwees#murmur)

[Ocho Floor Manager & Juggler Extraordinaire](https://jinn.works/uwees#ocho)

[Pockets Head of Approvals & Keeper of the Pen](https://jinn.works/uwees#pockets)

[Proof Triple-Check Fact Checker](https://jinn.works/uwees#proof)

[Wire GEO & AEO Engine Reporter](https://jinn.works/uwees#wire)

[All the Uwees](https://jinn.works/uwees)

- [Pricing](https://jinn.works/pricing)

[Sign In](https://jinn.works/login)

[Get Started](https://jinn.works/get-started)

[Let's Talk](https://jinn.works/contact)

Agents You can start this yourself today.

Sign in with Jinn from Claude, ChatGPT, Claude Code or Codex, or make a token for Cursor and other clients, then ask it about your brand.

[Connect Your Agent](https://jinn.works/get-started#connect)

[Open the developer reference](https://jinn.works/docs/mcp)

Start here

## Connect your agent.

Sign in

Add Jinn from [Claude's connector directory](https://claude.ai/directory/jinn) and sign in, with no token to paste. ChatGPT, Claude Code and Codex can sign in with Jinn too.

Or make a token

Make one in [your account panel](https://jinn.works/account/tokens) and keep it in your environment as `JINN_MCP_TOKEN`, never in a command or a shared file.

Add the server

One command for Claude Code, a config block for any other client, or one click for Cursor. The lines are below.

Ask

Ask your agent to call `get_token_context` first. It lists the brands it can reach. Then ask about your brand.

ChatGPT

## Add Jinn to ChatGPT.

Add the address

Add Jinn as a connector by its address, `https://app.jinn.works/api/mcp`, with no header.

Sign in

Then sign in with Jinn and pick a brand.

Plugin

## Jinn as a plugin.

For Claude Code, Jinn also comes as a plugin called Jinn Connect. It connects Claude Code to your brand record in one step, so Claude can read your voice, your kit and your design system while it works.

What it adds.

The Jinn connection, and one skill that checks the connection and tells you what your plan includes.

By hand, today.

Unzip the folder, run two commands, and paste your Jinn token when Claude Code asks. The token stays in Claude Code's secret store and goes only to Jinn. [Ask us for it](https://jinn.works/contact)

In a plugin store.

Coming.

Any AI agent signs in with Jinn and reads your brand's record. You sign in with Jinn from your assistant, and any change it suggests to that record waits for a person's approval.

[Pick Your Assistant](https://jinn.works/what-jinn-can-do/agents#pick-assistant)

## One call, start to finish

1. ### The handshake first

Plug makes the connection.

The agent opens the connection with `initialize` and your token.

2. ### The tools, by name

Ocho lays out the tools.

`tools/list` returns the tools your token can see.

3. ### The call and its answer

Drift reads the answer.

`tools/call` runs one tool, and your record answers.

The connection

## Three ways in, one gateway.

Plug, Head of Connections

The gateway lives at `https://app.jinn.works/api/mcp` and speaks standard MCP (Model Context Protocol) over HTTP: `JSON-RPC 2.0`, with a token on every call and three methods, `initialize`, `tools/list` and `tools/call`.

### MCP

One command. Keep the token in your environment as `JINN_MCP_TOKEN`, never in the command itself.

`claude mcp add --transport http jinn https://app.jinn.works/api/mcp --header 'Authorization: Bearer ${JINN_MCP_TOKEN}'`

Another client: the raw config block. It reads the token from `JINN_MCP_TOKEN`; if your client can't expand environment variables, put your token in the file on your own machine.

`{ "mcpServers": { "jinn": { "type": "http", "url": "https://app.jinn.works/api/mcp", "headers": { "Authorization": "Bearer ${JINN_MCP_TOKEN}" } } } }`

One-click install. Set `JINN_MCP_TOKEN` first; the link carries only a reference to it, never a secret.

Add Jinn to Cursor

### Skills

Open-source marketing skills, free to use. Each one stands on its own, and a connected brand makes its work specific to you. Add one with a single line:

`npx skills add JinnWorks/jinn-skills --skill brand-voice-content`

[Browse the catalog on GitHub](https://github.com/JinnWorks/jinn-skills)

### API

No client at all: POST to the gateway with `Authorization: Bearer YOUR_JINN_MCP_TOKEN`. The three methods, as wire bodies:

`{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-03-26", "capabilities": {} } }``{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }``{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "get_brand_dna_public", "arguments": { "slug": "paleo-pro" } } }`

The connection, in one table

What

How it works

Limits

The agent connection's limits: 120 requests a minute per token; a rotated token's old secret keeps working for 24 hours by default and 48 hours at most; a demo token lasts 60 minutes, with 3 active per address and 5 new ones an hour .

Tokens

A token is shown once. Jinn keeps only a one-way fingerprint of it.

The activity log

The activity log records the tool, the brand, the time and a fingerprint of the request, never the request itself. It is cleared after 90 days.

The tools

## The tools, by name.

Your token's own `tools/list` returns the tools it can see. A tool above your plan answers TIER_REQUIRED with the plan it needs; a tool that isn't offered to you reads as an unknown tool, on purpose. The live list, with each tool's inputs and answers, is in [the developer reference](https://jinn.works/docs/mcp).

`ping`

Checks the connection end to end. No arguments.

`get_token_context`

What your token can reach: your brands, its scopes, its plan and when it ends. Call it first.

`get_brand_dna_public`

The public part of a brand record: identity, voice, positioning, messaging pillars. What a demo token reads. On your own brand, Connected plan and up.

`get_brand_design_md`

Your brand's DESIGN.md, a design system written for agents to read. Connected plan and up.

`get_brand_design_tokens`

Your design tokens as DTCG JSON (the open design-token format): colors, type, spacing, radius, motion. Connected plan and up.

`ask_brand`

Ask a plain question about your brand; get back the facts in your record that bear on it, and what the record can't answer. The question is logged for the brand's owner. Connected plan and up.

`get_brand_kit`

The render-ready kit: colors, fonts, logo, name, spacing. Brand plan and up.

`get_brand_dna`

Your full brand record: identity, story, positioning, audience, voice, messaging pillars. Brand plan and up.

`get_brand_products`

Your products, one by one: description, ingredients, certifications, dimensions, link. Brand plan and up.

`get_brand_design_system`

The design system measured from your live site, each value with how sure it is. Brand plan and up.

`list_design_extraction_runs`

Each time your site's design was measured, newest first. Brand plan and up.

`get_product_design_system`

One product page's design, as the ways it differs from your brand's. Brand plan and up.

`create_brand`

Starts a brand of your own from its name and website, with a free preview read from the homepage. Not on a demo token.

`get_brand_status`

Where a new brand stands while Jinn reads it: queued, reading, ready or failed. Not on a demo token.

`list_my_brands`

Every brand you own on Jinn, and which one your agents read now. For agents signed in with Jinn.

`switch_brand`

Changes which of your brands your agents read, from the next call. For agents signed in with Jinn.

`propose_brand_edit`

Proposes changes to named fields of your record. Each one waits in your inbox, and nothing changes until you approve it. Connected plan and up.

`review_asset`

Reviews one of your images against your kit and voice: a verdict, findings by area and a short summary. Capped per person per day. Connected plan and up.

`search_assets`

Searches your own published assets by a short query. Each result has a download link that works for an hour. Connected plan and up.

`brief_task`

Before a task, a brief built from your record: the voice to use, the design rules, and what the record doesn't know; from Brand up, the products involved. Connected plan and up.

`get_brand_skill`

Packs your brand as a skill folder your agent installs: voice and design references, each file dated. Connected plan and up.

Tokens

## A token's life, start to finish.

Make

Make a token in your account panel. The secret is shown once and stored only as a hash.

Rotate

Rotating gives you a new secret while the old one keeps working for 24 hours by default and 48 at most, so nothing breaks mid-swap.

Revoke

Revoking takes effect at once, and a revoked token can't be rotated back to life.

Demo

A demo token lasts 60 minutes and can only read the showcase brands. Each IP address can hold 3 at once and make 5 an hour.

Demo token

## Try the gateway first.

No account yet: ask for a demo token from the command line. The answer carries the token, the address to connect to and how to add it.

`curl -X POST https://app.jinn.works/api/agents/request-demo-token`

Entitlement

## Your plan is read on every call.

A token carries no frozen plan. Its access is worked out from your live subscription on every request, and refused if the subscription can't be read, so an upgrade, a renewal or a lapse takes effect on the next call. There is nothing to re-make.

Errors

## Limits and errors, as your agent sees them.

What each error means

Code

What it means

`RATE_LIMITED (-32003)`

More than 120 requests a minute on one token. The response carries a Retry-After header to wait out.

`TIER_REQUIRED (-32004)`

A tool above your plan. The error carries the plan it needs and an upgrade link.

`QUOTA_EXCEEDED (-32005)`

Your plan's monthly allowance is used up.

`METHOD_NOT_FOUND (-32601)`

A tool that isn't offered to you reads as an unknown tool, so its existence stays hidden.

`FORBIDDEN_SCOPE (-32002)`

The token doesn't carry the permission this tool needs.

`not_found`

Any brand you can't reach returns the same not-found as a brand that doesn't exist.

`token_malformed`

The header isn't a well-formed Jinn token. Fix it rather than retry.

`token_invalid`

No live token matches: the secret is wrong or was never issued.

`token_revoked`

The token was revoked. Make a new one in your account panel.

`token_expired`

The token or its plan lapsed. The error carries a renewal link.

The four token errors answer HTTP 401 with the code in `error.data.code`. A tool error (-32000) also carries a machine-readable `data.kind` and a `retryable` flag, so an agent can decide whether to retry, fix or stop without reading the message.

Reference

## Terms and the full reference.

The [API terms](https://jinn.works/api-terms) govern gateway use. Each tool's request and response shapes live in [the developer reference](https://jinn.works/docs/mcp).

[See What Each Plan Adds](https://jinn.works/what-jinn-can-do/agents/how)

## Stuck on a step? Tell us where.

1. Tell us about your brand.

2. A person on our team reads it.

3. We read every application and reply within two business days.

[Let's Talk](https://jinn.works/contact?topic=agents)

[Jinn.](https://jinn.works/)

Small crew.
Enormous difference.

[Let's Talk](https://jinn.works/contact)

## Find Your Way

- [Home](https://jinn.works/)

- [What Jinn Can Do](https://jinn.works/what-jinn-can-do)

- [For E-commerce Brands](https://jinn.works/for/ecommerce)

- [For Agencies](https://jinn.works/for/agencies)

- [For Marketing Teams](https://jinn.works/for/marketing-teams)

- [For Startups & SMBs](https://jinn.works/for/smb)

- [For Individuals](https://jinn.works/for/individuals)

- [For AI Agents](https://jinn.works/for/agents)

- [How It Works](https://jinn.works/how-it-works)

- [Integrations](https://jinn.works/integrations)

- [Uwee U](https://jinn.works/uwee-u)

- [Meet the Uwees](https://jinn.works/uwees)

- [Pricing](https://jinn.works/pricing)

- [About](https://jinn.works/about)

- [Let's Talk](https://jinn.works/contact)

## What Jinn Can Do

- [Jinn](https://jinn.works/how-it-works)

- [Writing](https://jinn.works/what-jinn-can-do/writing)

- [Visibility](https://jinn.works/what-jinn-can-do/visibility)

- [Images](https://jinn.works/what-jinn-can-do/images)

- [Video](https://jinn.works/what-jinn-can-do/video)

- [Strategy](https://jinn.works/what-jinn-can-do/strategy)

- [Agents](https://jinn.works/what-jinn-can-do/agents)

- [Campaigns](https://jinn.works/what-jinn-can-do/campaigns)

## How It Works

- [The Whole Loop](https://jinn.works/how-it-works)

- [The Brand Record](https://jinn.works/how-it-works/schema)

- [What "Verified" Means](https://jinn.works/how-it-works/verified)

- [Guards and Spend](https://jinn.works/how-it-works/guards)

- [Models](https://jinn.works/how-it-works/models)

- [Measurement](https://jinn.works/how-it-works/measurement)

- [Your Data](https://jinn.works/how-it-works/your-data)

- [How Jinn Learns](https://jinn.works/how-it-works/learning)

## Compare

- [All Comparisons](https://jinn.works/compare)

- [Writing](https://jinn.works/what-jinn-can-do/writing/compare)

- [Visibility](https://jinn.works/what-jinn-can-do/visibility/compare)

- [Images](https://jinn.works/what-jinn-can-do/images/compare)

- [Video](https://jinn.works/what-jinn-can-do/video/compare)

- [Strategy](https://jinn.works/what-jinn-can-do/strategy/compare)

- [Agents](https://jinn.works/what-jinn-can-do/agents/compare)

## Stay Curious

- [Learn Jinn](https://jinn.works/uwee-u/learn)

- [Guides and Docs](https://jinn.works/uwee-u/guides)

- [Research](https://jinn.works/uwee-u/research)

- [Thinking](https://jinn.works/blog)

- [Release Notes](https://jinn.works/uwee-u/release-notes)

- [Off the Clock](https://jinn.works/uwees#off-the-clock)

- [Sign In](https://jinn.works/login)

## Your Next Brief

Bring a brand.
Make something that belongs to it.

[Bring Your Brand](https://jinn.works/demos)

[Let's Talk](https://jinn.works/contact)

Jinn [Privacy](https://jinn.works/privacy)

[Terms](https://jinn.works/terms)

[API Terms](https://jinn.works/api-terms)

[Contact](https://jinn.works/contact) hello@jinn.works Every brand shown on this site is an example brand, not a customer.

Machine-readable index: https://jinn.works/llms.txt · https://jinn.works/openapi.json
