> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contenthero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Overview

> Connect the hosted ContentHero MCP server over OAuth. Everything ContentHero can do, no key handling, account-scoped.

The hosted MCP server gives your agent everything ContentHero can do at **`https://mcp.contenthero.ai`** over OAuth. It is the preferred transport for agents: no key handling, one consent flow, and every call runs as you against your own account and credits. Tools appear as `mcp__contenthero__*`.

## Add ContentHero to your agent

<Steps>
  <Step title="Add the server">
    Point your agent host at `https://mcp.contenthero.ai`. Pick your host from the sidebar for exact config.
  </Step>

  <Step title="Consent once">
    On first use, the host opens a consent page. Sign in with your ContentHero account and approve. Your host receives a token; you never see or paste a key.
  </Step>

  <Step title="Use the tools">
    The ContentHero tools appear in your toolset, scoped to your account and refreshed by the host.
  </Step>
</Steps>

## Pick your host

<CardGroup cols={3}>
  <Card title="Claude Code" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/claudecode.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=baf1319b768485cedab5d7ab824955ab" href="/mcp/claude-code" width="16" height="16" data-path="icons/claudecode.svg" />

  <Card title="Claude Desktop & Web" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/claude.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=32c89c6c4f0d6dbf3215d60c76fe4174" href="/mcp/claude-desktop" width="16" height="16" data-path="icons/claude.svg" />

  <Card title="ChatGPT" icon="https://mintcdn.com/contenthero/9d1rc70uhXzjol7D/icons/openai.svg?fit=max&auto=format&n=9d1rc70uhXzjol7D&q=85&s=6cf8104c5704ccd315e9646fa0316545" href="/mcp/chatgpt" width="16" height="16" data-path="icons/openai.svg" />

  <Card title="Codex" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/codex.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=835db63991c01b35021b4797f9fd9cd9" href="/mcp/codex" width="16" height="16" data-path="icons/codex.svg" />

  <Card title="Cursor" icon="https://mintcdn.com/contenthero/9d1rc70uhXzjol7D/icons/cursor.svg?fit=max&auto=format&n=9d1rc70uhXzjol7D&q=85&s=c0e3416bf68c34c17673d01731c774d1" href="/mcp/cursor" width="16" height="16" data-path="icons/cursor.svg" />

  <Card title="VS Code" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/vscode.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=d40a4490484beef534bbb0db9875ba4a" href="/mcp/vscode" width="16" height="16" data-path="icons/vscode.svg" />

  <Card title="Windsurf" icon="https://mintcdn.com/contenthero/9d1rc70uhXzjol7D/icons/windsurf.svg?fit=max&auto=format&n=9d1rc70uhXzjol7D&q=85&s=1d7451489744727a7a6d1007d7f2ce44" href="/mcp/windsurf" width="16" height="16" data-path="icons/windsurf.svg" />

  <Card title="Antigravity" icon="https://mintcdn.com/contenthero/3ONfKVDlJouep1Sw/icons/antigravity.svg?fit=max&auto=format&n=3ONfKVDlJouep1Sw&q=85&s=f9af67a0dd562718d70e1fd66ac32bbd" href="/mcp/antigravity" width="16" height="16" data-path="icons/antigravity.svg" />

  <Card title="Cline" icon="https://mintcdn.com/contenthero/3ONfKVDlJouep1Sw/icons/cline.svg?fit=max&auto=format&n=3ONfKVDlJouep1Sw&q=85&s=0ce5fddd3d0c53163dea753956bf431a" href="/mcp/cline" width="16" height="16" data-path="icons/cline.svg" />

  <Card title="Gemini CLI" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/gemini.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=734c48fa1855b0498b234eca9d8f3dc4" href="/mcp/gemini-cli" width="16" height="16" data-path="icons/gemini.svg" />

  <Card title="Grok" icon="https://mintcdn.com/contenthero/9d1rc70uhXzjol7D/icons/grok.svg?fit=max&auto=format&n=9d1rc70uhXzjol7D&q=85&s=c4afcc5b13cbdb009d4b17529e7b4e48" href="/mcp/grok" width="16" height="16" data-path="icons/grok.svg" />

  <Card title="Perplexity" icon="https://mintcdn.com/contenthero/3ONfKVDlJouep1Sw/icons/perplexity.svg?fit=max&auto=format&n=3ONfKVDlJouep1Sw&q=85&s=dfb4a5f196534127862ccdc1fbe87ef3" href="/mcp/perplexity" width="16" height="16" data-path="icons/perplexity.svg" />

  <Card title="OpenClaw" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/openclaw.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=a85f6da85fb15e661442896980fd629e" href="/mcp/openclaw" width="16" height="16" data-path="icons/openclaw.svg" />

  <Card title="Hermes" icon="https://mintcdn.com/contenthero/bDMoqbtZm22CsyUJ/icons/hermesagent.svg?fit=max&auto=format&n=bDMoqbtZm22CsyUJ&q=85&s=289f68019a47ea2f00e880cf52a120f3" href="/mcp/hermes" width="16" height="16" data-path="icons/hermesagent.svg" />

  <Card title="Trae" icon="https://mintcdn.com/contenthero/3ONfKVDlJouep1Sw/icons/trae.svg?fit=max&auto=format&n=3ONfKVDlJouep1Sw&q=85&s=11f97f7268dbe67b67179a9ad5af2971" href="/mcp/trae" width="16" height="16" data-path="icons/trae.svg" />
</CardGroup>

Any MCP-compatible host works. If yours is not listed, see [Other hosts](/mcp/other-hosts) for the two universal setup patterns.

## What you get

Everything across five domains:

* **Generate:** image, video, audio, reference board, lip-sync, upscale, transcribe.
* **Pipeline:** create, assemble, schedule, and publish posts.
* **Brand:** read and edit your brand kit, and search, add to, and grow the knowledge base.
* **Inspiration:** outliers, tracked accounts, and brand-account performance.
* **Account:** balance and usage.

The model roster is live: it is the `modelId` enum on the generate tools, resolved from the registry at startup.

## Why OAuth

* **No key handling.** The token lives in the host, not the conversation.
* **Account-scoped.** Every call runs as you, against your own brand kits, media, and connected accounts.
* **Revocable.** Disconnect the server in your host, or revoke the session in the ContentHero app, and access stops.

## Verify

Once connected, ask your agent to read your balance (`get_balance`) or list your brand kits (`list_brand_kits`). A clean read confirms the connection and your scopes.
