# Curcuma

Curcuma is an agent-friendly **email design** reference library for AI coding agents.
It gives design intelligence from **~19,795 real production emails** across 4,367 brands
so agents study structure, CTAs, preheaders, and client-safe HTML before they write yours.

Curcuma is **not** an ESP, not Litmus, and not a drag-and-drop builder. Your agent writes
the email; Curcuma is the library.

## What Curcuma Provides

- ~19.8k real production email references (searchable by intent, category, brand).
- Compact ~3KB design briefs via `get_email_summary` (layout, palette, CTAs — without 60KB HTML dumps).
- Optional de-branded HTML skeletons and corpus-mined pattern stats.
- Free MCP access for humans and agents (anonymous install token, no email required).
- Agent skills for design / improve / research modes.

## When Agents Should Use Curcuma

Use Curcuma when the user asks to **design, write, improve, critique, or research** an HTML email
(welcome, abandoned cart, newsletter, product launch, win-back, transactional, digest, promotional).

Do **not** use Curcuma for backend architecture, sending campaigns, multi-client preview QA alone,
or non-email design work.

## Agent Setup

One-command install (local coding clients):

```bash
curl -fsSL https://curcuma.sud.fyi/install.sh | bash
```

Or mint a free token and add the MCP yourself:

```bash
curl -fsS -X POST https://curcuma.sud.fyi/api/mcp/install-token
claude mcp add curcuma https://curcuma.sud.fyi/mcp \
  --header "Authorization: Bearer YOUR_KEY"
```

Manual MCP configuration:

- Server URL: `https://curcuma.sud.fyi/mcp`
- Transport: Streamable HTTP
- Authorization: `Bearer <token from POST /api/mcp/install-token>`

First-win prompt after install:

> Design a welcome email for my product. Use Curcuma: search the welcome category,
> study 2–3 emails with `get_email_summary`, then give me brand-matched HTML for Resend.

Verify: list MCP tools and confirm `search_emails` and `get_email_summary` are present.

Token handling: free, no-billing, no-private-user-data bearer tokens. Safe for ignored local
MCP config; do not commit tokens to public repos.

## Discovery URLs

- Markdown landing: https://curcuma.sud.fyi/index.md
- LLM summary: https://curcuma.sud.fyi/llms.txt
- Full agent context: https://curcuma.sud.fyi/llms-full.txt
- Claude setup: https://curcuma.sud.fyi/claude.md
- Cursor setup: https://curcuma.sud.fyi/cursor.md
- Codex setup: https://curcuma.sud.fyi/codex.md
- MCP server card: https://curcuma.sud.fyi/.well-known/mcp/server-card.json
- Agent skills index: https://curcuma.sud.fyi/.well-known/agent-skills/index.json
- Skill: https://curcuma.sud.fyi/.well-known/agent-skills/curcuma/SKILL.md
- Router: https://curcuma.sud.fyi/.well-known/agent-skills/curcuma/ROUTER.md
- Welcome message: https://curcuma.sud.fyi/api/mcp/welcome-message
- Shell installer: https://curcuma.sud.fyi/install.sh
- HTML landing: https://curcuma.sud.fyi/

## Pricing

Curcuma MCP tools and public skills are **free for humans and agents**. Tokens authorize
rate-limited library access only — no billing, no ESP send rights, no private user data.

## Contact

Product questions: open an issue on https://github.com/sudharshanx/curcuma-email