Skip to main content

​
MCP Server

Connect Submagic to Claude, Claude Code, Cursor, or any MCP client with one URL: https://api.submagic.co/mcp.

​
Connect Claude

​
Authentication

Clients other than the Claude connector pass your existing Submagic API key as a Bearer token:
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.

​
Connecting Clients

​
Claude Code

​
Claude Desktop

The Claude connector above works in Claude Desktop and is the easier setup. Use the config below only if you’d rather use an API key.
Claude Desktop’s config file doesn’t speak HTTP transport directly, so we use the mcp-remote bridge.
Requires Node.js 20.18+ installed locally so npx can run mcp-remote.
To open the config file, go to Claude → Settings → Developer → Edit Config. Add the following:
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:

​
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.”
  • “Show my Submagic publishing stats for the last 30 days.”
  • “How did profile [id] perform this month — views, engagement, and follower growth?”
  • “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 for details.

Need help?

Reach out to support@submagic.co if you run into trouble connecting your MCP client.