MCP Server

The Cuppa MCP (Model Context Protocol) server lets AI clients like Cursor, Claude Desktop, Windsurf, and Cline access Cuppa natively. Your AI assistant can generate articles, grade content, manage Brand DNA, run research agents, and publish to your CMS, all from inside your editor.

What Is MCP?

MCP (Model Context Protocol) is an open standard that lets AI clients call external tools. When you add the Cuppa MCP server to your AI client, it discovers 75+ tools automatically. You can then ask your AI assistant to use Cuppa in natural language.

Requirements

• Node.js 18+ (needed for npx)
• Cuppa account on Solo plan or higher
• Cuppa API key (created in Team Settings)
• An MCP-compatible AI client (Cursor, Claude Desktop, Windsurf, Cline)

Setup

Step 1: Create an API Key

1. Go to Team Settings > API Keys
2. Click Create Key
3. Copy the key (starts with cpa-)

Step 2: Configure Your AI Client

Cursor

Add to .cursor/mcp.json in your project root (or global Cursor config):

{
  "mcpServers": {
    "cuppa": {
      "command": "npx",
      "args": ["-y", "@cuppa-ai/mcp-server"],
      "env": {
        "CUPPA_API_KEY": "cpa-your-key-here"
      }
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cuppa": {
      "command": "npx",
      "args": ["-y", "@cuppa-ai/mcp-server"],
      "env": {
        "CUPPA_API_KEY": "cpa-your-key-here"
      }
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Windsurf / Cline / Other MCP Clients

Same pattern. Point to npx -y @cuppa-ai/mcp-server with the CUPPA_API_KEY environment variable.

Step 3: Restart Your AI Client

After adding the config, restart your AI client. The Cuppa tools will be auto-discovered.

Step 4: Verify

Ask your AI assistant:

“Using Cuppa, list my sites.”

If it returns your brand list, you are connected.

Using Cuppa in Your AI Client

Once connected, just ask your AI assistant to do things with Cuppa in natural language:

• “Generate an article about content marketing best practices using my Brand DNA”
• “Grade this article for SEO and tell me what to improve”
• “Run my content gap research agent”
• “Publish this article to Ghost and create a LinkedIn post”
• “What are my top-performing keywords this month?”
• “Create a bulk project with 20 articles targeting these keywords”
• “Update my brand context with these new guidelines”
• “What topics are trending in my industry right now?”
• “Research what content formats are working on LinkedIn for SaaS brands”
• “Check my social analytics, find trending topics, then create posts for the best opportunities”

Your AI assistant selects the right Cuppa tools automatically based on your request.

Available Tools (75+)

Content Creation

Content Grading and SEO

Bulk Generation

Research and Trend Discovery

Brand DNA and Knowledge

Social Media

Slack (commands & approvals)

See Slack Integration for @Cuppa mention triggers.

Paid Ads tools pull live data from all connected Zernio ad platforms. Use site_id (required for campaigns/ads), optional platform (facebook, instagram, google, tiktok, linkedin, pinterest, twitter), from_date/to_date, and ad_account_id filters. list_ad_accounts with refresh=true syncs billable ad accounts first.

Images and Video

Video model picker: pass any of the following to create_video.model:

• replicate:runway-gen-4.5 (default - best benchmark quality)
• replicate:seedance-2.0 / replicate:seedance-2.0-fast (multimodal + native audio)
• replicate:kling-v3 (multi-shot + audio)
• replicate:veo-3.1-fast (fast + audio)
• replicate:grok-imagine-video (audio + image-to-video)
• replicate:p-video (drafts)
• wavespeed:higgsfield-dop-i2v (cinematic camera moves on a still - REQUIRES start_image_url)
• wavespeed:wan-2.7 (text-to-video by default; pass start_image_url for image-to-video, 5-15s)

Replicate models need a Replicate API key in Team Settings. WaveSpeed models need a WaveSpeed API key - get one at wavespeed.ai/accesskey.

Content Planning & Strategy

Clusters

Sites and Analytics

Research Agents

Presets, Templates, and Links

Mood Board

Pages

Performance Hub

Newsletters

Example Workflows

Generate and publish an article

“Using Cuppa, generate an article about sustainable packaging for ecommerce on my default site. When it’s done, grade it for SEO and publish it to Ghost.”

Run a research agent and create content from findings

“Trigger my content gap agent. When it finishes, show me the brief and generate articles for the top 3 opportunities.”

Bulk content production

“Create a Cuppa project with 15 articles targeting these keywords: [list]. Use my ‘Blog Post’ preset.”

Brand management

“Show me my Brand DNA. Update the brand context to mention that we now offer free shipping on all orders.”

Performance analysis

“Pull my full brand performance from the Cuppa Performance Hub. What are my quick wins? Show me any content decay and striking distance keywords.”

Data-driven social content (The Content Loop)

“Check my social analytics to see what’s working. Then research trending topics in my niche using Google Trends and web search. Use those insights plus my Brand DNA to create social posts for LinkedIn and X, and schedule them at the best posting times.”

This workflow follows the Content Loop: Measure (analytics) -> Research (trends) -> Context (brand) -> Create -> Schedule -> Iterate.

Trend research

“What topics are trending in AI marketing right now? Check Google Trends for the past 7 days and do a web search for what content formats are going viral on LinkedIn.”

The research_trends tool uses Google Trends (via DataForSEO) for rising queries, breakout topics, and trend direction. The research_web tool uses Perplexity Sonar Pro with focus modes: social_trends, industry_news, or competitor_analysis. Requires a Perplexity API key in Team Settings.

Newsletter generation

“Generate a newsletter from this week’s published articles on my default site. Show me the result.”

Environment Variables

Plan Requirements

The MCP server works on Solo plans and above. Some tools require higher plans:

Legacy plans: Power = Solo, Business = Studio, Agency = Scale, Agency+ = Enterprise.

Everything Syncs

All content created via the MCP server is stored in your Cuppa account. Articles, images, social posts, and planner items created from your AI editor appear in the Cuppa web app immediately.

MCP Resources

The MCP server also exposes resources that can be saved directly to disk without entering the AI context window. This is useful for exporting full article HTML without truncation.

In Cursor, use FetchMcpResource with the downloadPath parameter to save an article directly:

FetchMcpResource({
  server: "cuppa",
  uri: "cuppa://content/<article-id>",
  downloadPath: "content/blog/my-article.html"
})

This writes the complete HTML to your local filesystem, bypassing context window limits entirely.

Troubleshooting

“CUPPA_API_KEY environment variable is required” Make sure your API key is set in the env section of your MCP config. The key should start with cpa-.

Tools not appearing in your AI client Restart the AI client after adding the config. Check that Node.js 18+ is installed (node --version).

“Access denied. Please upgrade your plan” The tool you are using requires a higher plan tier. Check the plan requirements table above.

AI assistant does not use Cuppa tools Try being explicit: “Using Cuppa, …” or “Call the Cuppa MCP tool to …” Some AI clients need a direct mention to trigger tool use.

Also Available

• Cuppa CLI: Terminal commands for scripting, CI/CD, and AI agents with shell access
• REST API: Direct HTTP calls for custom integrations and automation platforms
• CLI vs MCP vs API: Comparison guide to choose the right interface

All three interfaces use the same API key and write to the same database.

Need Help?

• Documentation: learn.cuppa.ai
• Support: hello@cuppa.ai