Cuppa.ai

For AI agents

Programmatic SEO API for AI agents

Generate local service pages or programmatic pages from a CSV and a template, with SERP research per page.

@cuppa-ai/mcp-server@0.2.0@cuppa-ai/cli@0.1.8https://api.cuppa.ai/v1

Ask your agent

“Use Cuppa to create "roof repair in <city>" pages for these 20 cities.”

Output: Unique pages per location or row, ready to publish.

Tools and commands

  • MCP tools: create_page, get_page_status, create_serp_cluster_bulk, generate_from_serp_clusters
  • CLI: cuppa seo local --service "roof repair" --locations cities.txt --research-serps
  • REST: POST /v1/pages, POST /v1/research/serp-cluster-bulk
  1. Prepare. List the locations or rows.
  2. Generate. Run cuppa seo local or call create_page per row.

Keys and cost

  • Provider keys: A text model.
  • Cost: Plan fee plus your own tokens per page; bulk speed is 1x, 3x or 5x by plan.

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

Set up in one command

Claude Code
claude mcp add cuppa -e CUPPA_API_KEY=cpa-your-key -- npx -y @cuppa-ai/mcp-server

Other agents: Cursor, Codex, Claude Desktop, Windsurf, ChatGPT · Developers

FAQ

Are pages unique?
Each page can be researched against its own SERP before writing.