---
title: "SEO content API for AI agents | Cuppa AI"
url: https://cuppa.ai/use-cases/seo-content-api-for-ai-agents
description: "Research a keyword, write a long-form article in your brand voice, grade it against the live SERP, optimize it and publish to your CMS."
updated: 2026-11-18
mcp_server: @cuppa-ai/mcp-server@0.2.0
cli: @cuppa-ai/cli@0.1.8
---
# SEO content API for AI agents | Cuppa AI

Research a keyword, write a long-form article in your brand voice, grade it against the live SERP, optimize it and publish to your CMS.

Prompt: "Use Cuppa to write an SEO article about "best project management tools" for my brand, grade it, and fix anything under 80."

## How to do it

- MCP tools: `create_content`, `get_content_status`, `grade_content`, `optimize_content`, `publish_content`
- CLI: `cuppa generate "best project management tools"`
- REST: POST /v1/contents, GET /v1/contents/{id}/status, POST /v1/contents/{id}/grade, POST /v1/contents/{id}/optimize

1. **Pick the brand.** Call list_sites and choose the site id.
2. **Generate.** Call create_content with the keyword; it returns an id.
3. **Poll.** Call get_content_status until the article is complete.
4. **Grade and optimize.** Call grade_content, then optimize_content if the grade is low.
5. **Publish.** Call publish_content to push to the connected CMS (WordPress, Webflow, Shopify, Ghost, Sanity, Contentful).

Output: An HTML article with title, meta description, headings, FAQ, internal links and a content grade (0 to 100).

## Keys and cost

- Provider keys: OpenAI, Anthropic or Google (text model).
- Cost: Plan fee plus about $0.20 to $1.00 of your own tokens per ~2,000-word article.
- API, CLI and MCP access is included on every plan, including Solo. Plans from $99/month billed annually.

## FAQ

**Which CMSs can it publish to?**

WordPress, Webflow, Shopify, Ghost, Sanity, Contentful, plus Vercel/Astro pages and Google Drive export.

**Does Cuppa AI charge per article?**

No. You pay the flat plan fee; tokens are billed by your own AI provider with zero markup.

## Connect an agent



Claude Code:

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

Codex:

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

Cursor, Claude Desktop, Windsurf (mcp.json):

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

CLI:

```bash
npm i -g @cuppa-ai/cli
cuppa auth login --key cpa-your-key
cuppa auth status
```

REST:

```bash
curl -s https://api.cuppa.ai/v1/sites \
  -H "X-API-KEY: cpa-your-key"
```

Verify: `cuppa auth status` prints your team and key status. In MCP, ask the agent to call `list_sites`; it should return your brands.

---

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