Cuppa AI for Claude Desktop
Claude Desktop MCP for marketing: brand DNA, articles, images
Claude Desktop runs the Cuppa AI MCP server locally from claude_desktop_config.json. claude.ai in the browser has no Cuppa connector yet.
@cuppa-ai/mcp-server@0.2.0@cuppa-ai/cli@0.1.8https://api.cuppa.ai/v1
Install
{
"mcpServers": {
"cuppa": {
"command": "npx",
"args": [
"-y",
"@cuppa-ai/mcp-server"
],
"env": {
"CUPPA_API_KEY": "cpa-your-key"
}
}
}
}Replace cpa-your-key with a key from Team Settings → API Keys. Config file: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
- Restart Claude Desktop after editing the config.
- claude.ai (web) and Claude mobile can’t run local MCP servers. There is no hosted Cuppa connector yet.
Verify: cuppa auth status prints your team and key status. In MCP, ask the agent to call list_sites; it should return your brands.
Prompts to try
- “Use Cuppa to add my brand yourcompany.com, then show me its brand DNA and suggest 5 article ideas.”
- “Use Cuppa to show my content calendar for the next 30 days.”
What Claude Desktop can do with Cuppa AI
| Job | MCP tool | CLI | REST |
|---|---|---|---|
| SEO articles | create_content | cuppa generate "best project management tools" | POST /v1/contents |
| Brand DNA | create_site | cuppa site create --domain yourcompany.com | POST /v1/sites |
| Keyword and SERP research | research_keywords | cuppa research keywords -k "email marketing for dentists" | POST /v1/research/keywords |
| Ad creative | competitor_ads | cuppa brand ads --domain competitor.com | POST /v1/brand/competitor-ads |
| UGC video ads | generate_ugc_ad | cuppa brand ugc --script "<45-75 words>" --character <image-url> --voice <voice-url> [--confirm] | POST /v1/brand/ugc |
| Social posts and scheduling | generate_social_multi | cuppa social multi -s <site-id> -p linkedin,twitter --article-title "<title>" --article-summary "<summary>" | POST /v1/social/multi |
| Brand images | generate_image | cuppa image generate -s <site-id> -p "<prompt>" | POST /v1/images |
| Brand video | generate_video_script | cuppa video create -p "<prompt>" -m replicate:seedance-2.0-fast | POST /v1/video/script |
| AI visibility and search performance | get_brand_performance | cuppa performance overview | GET /v1/performance/overview |
| Website audit | run_website_audit | cuppa website-audit run | POST /v1/performance/website-audit |
| Programmatic and local SEO pages | create_page | cuppa seo local --service "roof repair" --locations cities.txt --research-serps | POST /v1/pages |
| PR pitches and newsletters | scan_pr_opportunities | cuppa --help | POST /v1/pr/scan |
| Brand listening and reviews | listen_brand_mentions | cuppa brand listen --brand "Your Brand" --domain yourcompany.com | POST /v1/brand/listen |
Authentication
- A human signs up for any plan at app.cuppa.ai (7-day free trial).
- They connect at least one AI provider key (BYOK) at https://app.cuppa.ai/team/settings/keys.
- They create a Cuppa AI API key (starts with cpa-) at https://app.cuppa.ai/team/settings/api/keys.
- They give that key to the agent as CUPPA_API_KEY. REST calls send it in the X-API-KEY header.
Pricing
Two separate costs. (1) A flat Cuppa AI plan fee, below. (2) AI usage, billed to you directly by your own AI providers (OpenAI, Anthropic, Google, Replicate, Perplexity, xAI) at their published rates. Cuppa AI adds zero markup and does not bill usage.
| Plan | Monthly | Annual | Brands | Seats |
|---|---|---|---|---|
| Solo | $119/mo | $99/mo, billed $1,188/yr | 1 brand | 1 seat |
| Studio | $249/mo | $199/mo, billed $2,388/yr | 3 brands | Up to 3 seats |
| Scale | $449/mo | $369/mo, billed $4,428/yr | 10 brands | Up to 10 seats |
| Enterprise | $1,099/mo | $899/mo, billed $10,788/yr | Up to 20 brands | Up to 30 seats |
7-day free trial on every plan. Fair-use policy on all plans. API, CLI and MCP access is included on every plan, including Solo. Full pricing
FAQ
- Does Cuppa AI work with Claude Desktop?
- Yes. Claude Desktop runs the Cuppa AI MCP server locally with npx. Every plan includes MCP, CLI and API access.
- What does it cost?
- A flat plan fee from $99/month (billed annually) or $119/month. AI usage is billed by your own providers with zero markup.
- Can the agent sign up by itself?
- No. A human creates the account and the API key, then gives the key to the agent.
More: Developers · llms.txt