Connect CartViral to Claude, Codex and Cursor (MCP)

Last updated: 24 September 2026

What your agent can do

Fastest: add a connector (no key)

Any client that supports MCP OAuth connects with just the URL https://app.cartviral.com/mcp: it opens a CartViral sign-in, you approve access once, and the client gets its own revocable token.

• Claude (web and desktop): Settings → Connectors → Add custom connector → paste the URL → Connect.
• ChatGPT: add a custom app/connector in developer mode with the same URL and OAuth authentication.
• Claude Code: claude mcp add --transport http cartviral https://app.cartviral.com/mcp, then run /mcp and choose Authenticate.

Connected apps are listed in Account → AI agents, where you can disconnect them.

Listed in the official MCP Registry (com.cartviral/cartviral) and on Smithery. Docs and manifest: github.com/artemecom/cartviral-mcp.

With an API key

Step 1. Create an API key

Sign in at app.cartviral.com/account/agents, name the key (for example "Claude Code") and create it. The key is shown once. You can revoke it on the same page.

Step 2. Add CartViral to your agent

Claude Code

claude mcp add --transport http cartviral https://app.cartviral.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Codex CLI

In ~/.codex/config.toml:

[mcp_servers.cartviral]
url = "https://app.cartviral.com/mcp"
bearer_token_env_var = "CARTVIRAL_API_KEY"

Then in your shell profile: export CARTVIRAL_API_KEY="YOUR_KEY".

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "cartviral": {
      "url": "https://app.cartviral.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop

Settings → Developer → Edit config, then add:

{
  "mcpServers": {
    "cartviral": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.cartviral.com/mcp",
               "--header", "Authorization: Bearer YOUR_KEY"]
    }
  }
}

Any other MCP client

Streamable HTTP transport, URL https://app.cartviral.com/mcp, header Authorization: Bearer YOUR_KEY.

Step 3. Ask

• "Import https://yourstore.com and show me the 5 products with the best CartViral score."
• "Make 3 AI story clips of the top product and give me the download links when they're ready."
• "Find CartViral Earn offers that ship to the US with at least 20% commission and join the best one."
• "Pitch these Shopify brands: [links]. Tomorrow, tell me which ones opened the page."

Security and limits

• A key acts as your account: it spends your credits, with the same limits as the cabinet. Keep it private and revoke it if it leaks.
• Up to 120 calls per minute per key; up to 10 keys per account.
• Agents never post to social media for you: they make and fetch clips, you post.
• Connectors get OAuth tokens (PKCE, 1-hour access tokens, rotating refresh tokens) instead of your key; disconnect any app in Account → AI agents.

FAQ

More guides: Best AI product video generators · Creatify alternatives · Content Rewards alternative · Product link to TikTok video · Earn with AI product videos · n8n and Make · Shopify Collabs alternative · API