---
title: "Claude Code MCP for marketing: SEO articles, ad creative, UGC video | Cuppa AI"
url: https://cuppa.ai/agents/claude-code
description: "Add Cuppa AI to Claude Code with one command. Claude Code can then run marketing jobs against your brand from the terminal."
updated: 2026-11-18
mcp_server: @cuppa-ai/mcp-server@0.2.0
cli: @cuppa-ai/cli@0.1.8
---
# Claude Code MCP for marketing: SEO articles, ad creative, UGC video | Cuppa AI

Add Cuppa AI to Claude Code with one command. Claude Code can then run marketing jobs against your brand from the terminal.

## Install

Add the MCP server:

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

Replace `cpa-your-key` with a key from https://app.cuppa.ai/team/settings/api/keys.


- Claude Code can also shell out to the CLI (`npm i -g @cuppa-ai/cli`); every command supports `--format json`.
- Check it is connected with `claude mcp list`.

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 and grade an article on "<keyword>", then publish it to WordPress."
- "Use Cuppa to generate 6 ad creatives for our spring sale."
- "Use Cuppa to turn my latest article into LinkedIn and X posts."

## What it can do

| Job | MCP tools | CLI | REST |
| --- | --- | --- | --- |
| [SEO articles](https://cuppa.ai/use-cases/seo-content-api-for-ai-agents.md) | create_content, get_content_status, grade_content | `cuppa generate "best project management tools"` | POST /v1/contents |
| [Brand DNA](https://cuppa.ai/use-cases/brand-dna-api-for-ai-agents.md) | create_site, get_brand, update_brand_context | `cuppa site create --domain yourcompany.com` | POST /v1/sites |
| [Keyword and SERP research](https://cuppa.ai/use-cases/keyword-research-api-for-ai-agents.md) | research_keywords, research_serp, research_competitors | `cuppa research keywords -k "email marketing for dentists"` | POST /v1/research/keywords |
| [Ad creative](https://cuppa.ai/use-cases/ad-creative-api-for-ai-agents.md) | competitor_ads, generate_ad, get_ad_batch_status | `cuppa brand ads --domain competitor.com` | POST /v1/brand/competitor-ads |
| [UGC video ads](https://cuppa.ai/use-cases/ugc-video-ad-api-for-ai-agents.md) | generate_ugc_ad, find_creators | `cuppa brand ugc --script "<45-75 words>" --character <image-url> --voice <voice-url> [--confirm]` | POST /v1/brand/ugc |
| [Social posts and scheduling](https://cuppa.ai/use-cases/social-media-scheduling-api-for-ai-agents.md) | generate_social_multi, generate_carousel, schedule_social | `cuppa social multi -s <site-id> -p linkedin,twitter --article-title "<title>" --article-summary "<summary>"` | POST /v1/social/multi |
| [Brand images](https://cuppa.ai/use-cases/on-brand-image-generation-api-for-ai-agents.md) | generate_image, generate_images_bulk, generate_mood_board | `cuppa image generate -s <site-id> -p "<prompt>"` | POST /v1/images |
| [Brand video](https://cuppa.ai/use-cases/brand-video-generation-api-for-ai-agents.md) | generate_video_script, create_video, get_video_status | `cuppa video create -p "<prompt>" -m replicate:seedance-2.0-fast` | POST /v1/video/script |
| [AI visibility and search performance](https://cuppa.ai/use-cases/ai-visibility-tracking-api-for-ai-agents.md) | get_brand_performance, get_bing_performance, get_ai_visibility | `cuppa performance overview` | GET /v1/performance/overview |
| [Website audit](https://cuppa.ai/use-cases/website-audit-api-for-ai-agents.md) | run_website_audit, get_website_audit, get_website_audit_opportunities | `cuppa website-audit run` | POST /v1/performance/website-audit |
| [Programmatic and local SEO pages](https://cuppa.ai/use-cases/programmatic-seo-api-for-ai-agents.md) | create_page, get_page_status, create_serp_cluster_bulk | `cuppa seo local --service "roof repair" --locations cities.txt --research-serps` | POST /v1/pages |
| [PR pitches and newsletters](https://cuppa.ai/use-cases/pr-pitch-api-for-ai-agents.md) | scan_pr_opportunities, generate_pr_pitch, list_pr_contacts | `cuppa --help` | POST /v1/pr/scan |
| [Brand listening and reviews](https://cuppa.ai/use-cases/brand-monitoring-api-for-ai-agents.md) | listen_brand_mentions, scan_reviews, enrich_company | `cuppa brand listen --brand "Your Brand" --domain yourcompany.com` | POST /v1/brand/listen |

## Authentication (a human does this once)

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.

---

Index of every Markdown page: https://cuppa.ai/llms.txt · Setup: https://cuppa.ai/developers.md · Pricing: https://cuppa.ai/pricing.md
