Cuppa.ai

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

~/.codeium/windsurf/mcp_config.json
{
  "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

JobMCP toolCLIREST
SEO articlescreate_contentcuppa generate "best project management tools"POST /v1/contents
Brand DNAcreate_sitecuppa site create --domain yourcompany.comPOST /v1/sites
Keyword and SERP researchresearch_keywordscuppa research keywords -k "email marketing for dentists"POST /v1/research/keywords
Ad creativecompetitor_adscuppa brand ads --domain competitor.comPOST /v1/brand/competitor-ads
UGC video adsgenerate_ugc_adcuppa brand ugc --script "<45-75 words>" --character <image-url> --voice <voice-url> [--confirm]POST /v1/brand/ugc
Social posts and schedulinggenerate_social_multicuppa social multi -s <site-id> -p linkedin,twitter --article-title "<title>" --article-summary "<summary>"POST /v1/social/multi
Brand imagesgenerate_imagecuppa image generate -s <site-id> -p "<prompt>"POST /v1/images
Brand videogenerate_video_scriptcuppa video create -p "<prompt>" -m replicate:seedance-2.0-fastPOST /v1/video/script
AI visibility and search performanceget_brand_performancecuppa performance overviewGET /v1/performance/overview
Website auditrun_website_auditcuppa website-audit runPOST /v1/performance/website-audit
Programmatic and local SEO pagescreate_pagecuppa seo local --service "roof repair" --locations cities.txt --research-serpsPOST /v1/pages
PR pitches and newslettersscan_pr_opportunitiescuppa --helpPOST /v1/pr/scan
Brand listening and reviewslisten_brand_mentionscuppa brand listen --brand "Your Brand" --domain yourcompany.comPOST /v1/brand/listen

Authentication

  1. A human signs up for any plan at app.cuppa.ai (7-day free trial).
  2. They connect at least one AI provider key (BYOK) at https://app.cuppa.ai/team/settings/keys.
  3. They create a Cuppa AI API key (starts with cpa-) at https://app.cuppa.ai/team/settings/api/keys.
  4. 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.

PlanMonthlyAnnualBrandsSeats
Solo$119/mo$99/mo, billed $1,188/yr1 brand1 seat
Studio$249/mo$199/mo, billed $2,388/yr3 brandsUp to 3 seats
Scale$449/mo$369/mo, billed $4,428/yr10 brandsUp to 10 seats
Enterprise$1,099/mo$899/mo, billed $10,788/yrUp to 20 brandsUp 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