Connect CartViral to Claude, ChatGPT, Codex and Cursor (MCP)
Last updated: 3 November 2026
Fastest: add a connector (no key)
Any client that supports MCP sign-in 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. The same page in the app has copy buttons and one-click installs: Claude & ChatGPT in the CartViral menu.
- Claude (web, desktop app, phone): Settings → Connectors → Add custom connector → name CartViral, paste the URL → Connect → approve in CartViral.
- ChatGPT: Settings → Apps → Advanced settings → turn on Developer mode → create an app with the same URL and OAuth → approve in CartViral, then turn CartViral on in a chat. Developer mode needs a paid ChatGPT plan.
- Claude Code:
claude mcp add --transport http cartviral https://app.cartviral.com/mcp, then run/mcpand choose Authenticate. - Cursor and VS Code: one-click install buttons on the Claude & ChatGPT page, then sign in when asked.
Connected apps are listed on the same page, where you can disconnect them. Bonus: after your first purchase, the first time an agent connects to your account 20 credits land on your balance (once per account).
Listed in the official MCP Registry (com.cartviral/cartviral) and on Glama. Server card: app.cartviral.com/.well-known/mcp.json. Docs and manifest: github.com/artemecom/cartviral-mcp.
If your assistant says it can't reach CartViral
- It can't add the connector by itself. Claude and ChatGPT only use CartViral after you add it once in their settings (steps above). Until then they can only read about it on the web.
- Web search is off. Turn on web search in the chat, or paste
https://cartviral.com/llms.txt: it describes every product and price in plain text. - It tried from its code sandbox. The code tool in Claude and ChatGPT has no open internet. Ask it to use the CartViral connector instead of running code.
- A work or team account. An admin may have to allow custom connectors for the workspace first.
- Sign-in loops. Make sure you sign in to the same CartViral account you want the agent to use, then approve the request.
What your agent can do
Everything the cabinet does. Clips, photos and other paid work spend your account's credits at the same prices; a failed job refunds itself.
| Tool | What it does | Credits |
|---|---|---|
| get_account | Plan, credit balance, price of each clip type | 0 |
| import_products, list_products | Import a Shopify catalog (up to 750 products) or one product page from Shopify, Amazon, Etsy and most sites; catalog with CartViral score | 0 |
| generate_clips, list_clips | Montage, AI story reel or creator (UGC) clip of a product, 9:16, optionally starring a brand character; status and download links | 1 / 6 / 12 per clip |
| remake_from_reference | A proven video's structure and story (hook, beats, timings) remade, with your product or without one | 6 |
| generate_photos, generate_carousel, generate_static_ads | AI photo sets (model, product, infographic), Instagram and TikTok carousels, static ads for Meta and TikTok | 7 to 9 / 3 / 4 per set |
| list_photo_sets, list_carousels, list_static_ads | Status and download links of the photo sets, carousels and static ads above | 0 |
| get_listing_copy, get_copy | Marketplace listing and SEO copy, ad copy, social captions, a creator brief, a 30-day content plan | 1 first time, then free |
| create_image | Images from your own prompt with up to 3 reference photos (a face, a product, a style): YouTube covers at 16:9, banners, scenes | 1 per image |
| create_video | A 4-10 s video from your prompt, with camera moves (dolly zoom, crane, orbit, push in, whip pan, low angle) and sound | 2 on our engine |
| make_cinematic | A 15 or 30 s brand film with a pro model, every frame a banner | 12 / 18 |
| make_angles, make_talking_photo | New angles of one photo; a photo that says your text in any language | 1 per angle / 2 per 10 s take |
| reframe_video, remove_background, breakdown_video | Change a video's frame; cut-out PNG; why a viral video works (hook, beats, timings) | 1 / 1 / 0 |
| copy_motion | The person from a photo repeats a reference video's movement (dance, gesture, walk), up to 15 s; only when premium video is switched on | Premium, priced by length |
| create_character, save_character, list_characters | A recurring person for the brand: the same face in every clip | 2 for 2 portraits |
| list_creations, get_create_options, upload_media | Results of the tools above; models and prices; store a file | 0 |
| list_offers, join_offer, bring_a_brand, list_pitches | Creators: brand offers in CartViral Earn and your tracking link; pitch a brand with 3 AI clips and a page | 0 / 18 per pitch |
Image and video arguments take any public https file link (CartViral downloads it once) or a CartViral link. Premium video models and their prices: get_create_options.
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, with a copy button. 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. The same operations are a REST API: cartviral.com/api.
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."
- "Make a YouTube cover at 16:9: me from this photo looking shocked, the product in my hand, big title MY STORE MADE $10K."
- "Create a brand character, a woman in her 20s with freckles, save the better portrait as Mia and use her in 3 creator clips."
- "Find CartViral Earn offers that ship to the US with at least 50% commission and join the best one."
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 files, you post.
- Connectors get OAuth tokens (PKCE, 1-hour access tokens, rotating refresh tokens) instead of your key; disconnect any app on the Claude & ChatGPT page.
FAQ
Does CartViral have an MCP server?
Yes: https://app.cartviral.com/mcp, Streamable HTTP, with OAuth sign-in for connectors or an API key. It is listed in the official MCP Registry as com.cartviral/cartviral, and its server card is at https://app.cartviral.com/.well-known/mcp.json.
Which agents work with it?
Claude (custom connector), ChatGPT (developer mode app), Claude Code, Codex CLI, Cursor, VS Code, Claude Desktop and any MCP client that supports Streamable HTTP with OAuth or a bearer token.
Can the agent make an image from my own prompt, like a YouTube cover with my face?
Yes: create_image takes your prompt and up to 3 reference photos (a face, a product, a style) and makes 1, 2 or 4 images in 9:16, 4:5, 1:1 or 16:9, 1 credit each. It is not tied to a catalog product.
Does it cost extra?
No. Tools that only read data are free; everything else is paid from your account's credits at the cabinet's prices (for example 1 for a montage, 6 for an AI story reel, 12 for a creator (UGC) clip, 1 per image). After your first purchase, the first time an agent connects to your account you get 20 bonus credits, once per account.
My assistant says it has no access to CartViral. What do I do?
Add CartViral once as a connector in the assistant's settings (Claude: Settings → Connectors; ChatGPT: Settings → Apps, developer mode) with https://app.cartviral.com/mcp. Assistants can't add connectors themselves, and their code sandboxes have no open internet.
Can the agent publish to TikTok?
No. It makes clips and returns download links; you post them yourself.
Free account, 18 free credits, no card. Copy the link, paste it into Claude or ChatGPT.
Open Claude & ChatGPTMore guides: Best AI product video generators · Creatify alternatives · Topview alternatives · Revid alternatives · Content Rewards alternative · Trybe alternatives · Product link to TikTok video · Earn with AI product videos · n8n and Make · Shopify Collabs alternative · API · Start a Shopify affiliate program · AI video affiliate programs · Faceless affiliate with AI videos · Clipping jobs: per view vs per sale · Arcads pricing · Creatify pricing · Creatify vs Arcads · Higgsfield alternatives · Product videos from photos · Etsy listing videos · Shopify product page video · TikTok Shop product videos · TikTok Shop affiliate without followers · Get paid to post product videos · How to find clipping jobs