Connect Your AI Tool

Before you start

1. You need an Adsumo account. Sign up at adsumo.ai if you don't have one.
2. No API key required. Adsumo MCP uses OAuth — you'll sign in and approve access in your browser the first time you use it.
3. Browsing your brands, products, and the ad library works on any plan. Generating ads requires a paid plan.

The connector URL is:

https://www.adsumo.ai/api/mcp

Add this URL in your AI tool, then run any Adsumo tool. Your tool opens a browser window to sign in and approve access — that's it.

Claude (web & desktop)

1. Open Settings → Connectors.
2. Click Add custom connector.
3. Name it Adsumo and paste the connector URL above.
4. Click Connect, then sign in and approve access when Adsumo opens.

ChatGPT

1. Open Settings → Apps (custom connectors).
2. Click Add app and paste the connector URL above.
3. Add it, then sign in and approve access.

Claude Code

Add the server from your terminal:

claude mcp add --transport http adsumo https://www.adsumo.ai/api/mcp

Then run any Adsumo tool — Claude Code opens a browser window to sign in and approve access. No headers or keys needed.

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "adsumo": {
      "url": "https://www.adsumo.ai/api/mcp"
    }
  }
}

Reload, then run an Adsumo tool to sign in and approve access.

VS Code

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "adsumo": {
      "type": "http",
      "url": "https://www.adsumo.ai/api/mcp"
    }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.adsumo]
url = "https://www.adsumo.ai/api/mcp"

Manus

1. Open Settings → Integrations → Custom MCP Servers.
2. Click Add Server.
3. Paste the connector URL above as the Server URL.
4. Save and connect, then sign in and approve access.

Perplexity

Requires a paid Perplexity plan.

1. Open Settings → Connectors and click Add custom connector.
2. Paste the connector URL above and choose Streamable HTTP as the transport.
3. Connect, then sign in and approve access.

Any other MCP client

Any client that supports custom MCP connectors over HTTP with OAuth can connect — including OpenClaw, Hermes, and others. Add the connector URL above, run a tool, and complete the browser sign-in. Do not add an Authorization header; the OAuth flow handles authentication.

Verifying the connection

Once configured, ask your AI tool to run the get_credits tool. If the connection is working, it returns your team's credit balance:

{
  "credits_used": 45,
  "credits_limit": 300,
  "credits_remaining": 255
}

If it doesn't work, check that:

• You completed the browser sign-in and approved access.
• You used the exact connector URL with no Authorization header.
• For generation, your team is on a paid plan — read-only tools (brands, products, credits, ad library) work on any plan, but generate_image, generate_ai_video, and other generation tools need an active subscription.

If tool calls suddenly start failing after working before, your access token may have expired. Re-run a tool to trigger a fresh sign-in (some MCP clients don't yet refresh tokens automatically).