Cuppa AI for Windsurf
Windsurf MCP for marketing: SEO articles, social, images
Add Cuppa AI to Windsurf’s MCP config.
@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: ~/.codeium/windsurf/mcp_config.json.
- Refresh MCP servers in Windsurf after saving.
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 write social posts announcing this release.”
What Windsurf 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 Windsurf?
- Yes. Windsurf 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