Cuppa AI for Codex
Codex MCP for marketing: SEO, social, ad creative
Add Cuppa AI to the Codex CLI as an MCP server, or let Codex call the Cuppa CLI or REST API with curl.
@cuppa-ai/mcp-server@0.2.0@cuppa-ai/cli@0.1.8https://api.cuppa.ai/v1
Install
codex mcp add cuppa --env CUPPA_API_KEY=cpa-your-key -- npx -y @cuppa-ai/mcp-servernpm i -g @cuppa-ai/cli
cuppa auth login --key cpa-your-key
cuppa auth statusReplace cpa-your-key with a key from Team Settings → API Keys. Config file: ~/.codex/config.toml.
- If the sandbox blocks network access to api.cuppa.ai, allow it or tell the human; do not work around it.
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 audit my website and fix the top 3 issues in this repo.”
What Codex 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 Codex?
- Yes. Codex 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