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

# MCP Server

> Connect Submagic to Claude Code, Claude Desktop, Cursor, and other MCP clients

# MCP Server

Submagic exposes an [MCP](https://modelcontextprotocol.io)-compatible endpoint at `POST https://api.submagic.co/mcp`. Connect from Claude Code, Claude Desktop, Cursor, or any MCP client to drive Submagic from inside your AI assistant.

## Authentication

Pass your existing Submagic API key as a Bearer token:

```http theme={null}
Authorization: Bearer sk-your-api-key-here
```

The same key and credits that work for the REST API work for MCP. If you don't have a key yet, generate one from your [account settings](https://app.submagic.co/user).

## Connecting Clients

### Claude Code

```bash theme={null}
claude mcp add --transport http submagic https://api.submagic.co/mcp \
  --header "Authorization: Bearer $SUBMAGIC_API_KEY"
```

### Claude Desktop

Claude Desktop's config file doesn't speak HTTP transport directly, so we use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge.

<Warning>
  Requires Node.js **20.18+** installed locally so `npx` can run `mcp-remote`.
</Warning>

To open the config file, go to **Claude → Settings → Developer → Edit Config**. Add the following:

<Tabs>
  <Tab title="macOS / Linux">
    ```json theme={null}
    {
      "mcpServers": {
        "submagic": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://api.submagic.co/mcp",
            "--header",
            "Authorization: Bearer YOUR_API_KEY_HERE"
          ]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windows">
    ```json theme={null}
    {
      "mcpServers": {
        "submagic": {
          "command": "cmd",
          "args": [
            "/c",
            "npx",
            "-y",
            "mcp-remote",
            "https://api.submagic.co/mcp",
            "--header",
            "Authorization: Bearer YOUR_API_KEY_HERE"
          ]
        }
      }
    }
    ```
  </Tab>
</Tabs>

Save, then fully quit and reopen Claude Desktop. Submagic tools will appear under the hammer icon at the bottom of the chat.

### Cursor / Windsurf

Configure an HTTP MCP server pointing at `https://api.submagic.co/mcp` with the header:

```http theme={null}
Authorization: Bearer YOUR_API_KEY_HERE
```

### claude.ai web (Custom Connectors)

<Warning>
  Currently unsupported — claude.ai's Custom Connectors require OAuth, not Bearer
  tokens. Use Claude Code, Claude Desktop, Cursor, or Windsurf for now.
</Warning>

## Example Prompts

Once connected, you can ask your assistant things like:

* "Create a Submagic project from this URL."
* "Turn this YouTube video into Submagic Magic Clips."
* "Show me the status of my recent Submagic projects."
* "Export Submagic project `[id]` and publish it to TikTok and Instagram."
* "List my published Submagic projects from the last week with their views."
* "Add background music to Submagic project `[id]`."
* "What Submagic caption templates are available?"

## Rate Limits & Credits

MCP tool calls share the same rate limits and credit pool as the REST API — see [Rate Limits](/rate-limits) for details.

<Card title="Need help?" icon="life-ring">
  Reach out to [support@submagic.co](mailto:support@submagic.co) if you run into
  trouble connecting your MCP client.
</Card>