---
title: "Brand DNA API for AI agents | Cuppa AI"
url: https://cuppa.ai/use-cases/brand-dna-api-for-ai-agents
description: "Extract a brand’s identity from its domain (voice, tone, audience, products, competitors, logos, colors, fonts) and give every other job that context."
updated: 2026-11-18
mcp_server: @cuppa-ai/mcp-server@0.2.0
cli: @cuppa-ai/cli@0.1.8
---
# Brand DNA API for AI agents | Cuppa AI

Extract a brand’s identity from its domain (voice, tone, audience, products, competitors, logos, colors, fonts) and give every other job that context.

Prompt: "Use Cuppa to add yourcompany.com and summarize its brand DNA: voice, audience, competitors and colors."

## How to do it

- MCP tools: `create_site`, `get_brand`, `update_brand_context`, `update_brand_voice`, `update_brand_visual_style`
- CLI: `cuppa site create --domain yourcompany.com && cuppa brand get <siteId>`
- REST: POST /v1/sites, GET /v1/sites/{id}/brand, PUT /v1/sites/{id}/brand/context

1. **Create the site.** Call create_site with the domain.
2. **Read the DNA.** Call get_brand with the site id.
3. **Correct it.** Call update_brand_context, update_brand_voice or update_brand_visual_style.

Output: Structured brand context, active brand voice and visual style (colors, fonts, mood).

## Keys and cost

- Provider keys: None for onboarding; Cuppa AI covers brand extraction cost.
- Cost: Included in the plan fee. Each plan includes a set number of brands (1, 3, 10 or up to 20).
- API, CLI and MCP access is included on every plan, including Solo. Plans from $99/month billed annually.

## FAQ

**What does brand DNA include?**

Company info, products, audience, tone and voice, competitors, logos, color palette and typography.

**Does it cost provider tokens?**

No. Cuppa AI pays for brand extraction and initial research.

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