---
title: "Ad creative API for AI agents | Cuppa AI"
url: https://cuppa.ai/use-cases/ad-creative-api-for-ai-agents
description: "Generate on-brand static ad creative in batches, review competitor ads from Google and Meta ad libraries, and manage creatives."
updated: 2026-11-18
mcp_server: @cuppa-ai/mcp-server@0.2.0
cli: @cuppa-ai/cli@0.1.8
---
# Ad creative API for AI agents | Cuppa AI

Generate on-brand static ad creative in batches, review competitor ads from Google and Meta ad libraries, and manage creatives.

Prompt: "Use Cuppa to pull my top competitor’s Meta ads, then generate 6 on-brand ad creatives for our spring sale."

## How to do it

- MCP tools: `competitor_ads`, `generate_ad`, `get_ad_batch_status`, `list_ad_creatives`, `update_ad_creative`
- CLI: `cuppa brand ads --domain competitor.com`
- REST: POST /v1/brand/competitor-ads, POST /v1/social/ads/creatives, GET /v1/social/ads/creatives/status

1. **Research.** Call competitor_ads with a competitor domain or advertiser.
2. **Generate.** Call generate_ad with the offer and count; it returns a batch id.
3. **Poll.** Call get_ad_batch_status until creatives are ready.

Output: Ad creatives (image plus headline and copy) using your brand colors, fonts and voice.

## Keys and cost

- Provider keys: An image model key (Replicate, OpenAI or Google) plus a text model.
- Cost: Plan fee plus your image provider’s rate, about $0.15 per image on Nano Banana Pro.
- API, CLI and MCP access is included on every plan, including Solo. Plans from $99/month billed annually.

## FAQ

**Can it read competitor ads?**

Yes, from the Google Ads Transparency Center and the Meta Ad Library, by domain, page id or advertiser.

## 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
