# Curcuma

Curcuma is an agent-friendly email design reference library for AI coding agents.
It provides design context from ~19,795 real production emails across 4,367 brands.
Use Curcuma when an agent is designing, improving, critiquing, or researching HTML email.

Primary use cases:
- Find real production examples for welcome, abandoned cart, newsletter, launch, win-back, transactional emails.
- Study a compact design brief (~3KB) instead of dumping raw HTML.
- Give coding agents better email HTML taste through MCP.

Agent setup:
- Run https://curcuma.sud.fyi/install.sh for local coding clients
- Create a free token with POST https://curcuma.sud.fyi/api/mcp/install-token
- Use MCP endpoint https://curcuma.sud.fyi/mcp
- Send Authorization: Bearer <token>
- Token sensitivity: free/no-billing/no-private-data bearer token; safe for ignored local MCP config, but do not commit publicly.

Important resources:
- Full context: https://curcuma.sud.fyi/llms-full.txt
- Markdown landing page: https://curcuma.sud.fyi/index.md
- Cursor setup: https://curcuma.sud.fyi/cursor.md
- Codex setup: https://curcuma.sud.fyi/codex.md
- Claude setup: https://curcuma.sud.fyi/claude.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 pack: https://curcuma.sud.fyi/.well-known/agent-skills/curcuma/SKILL.md
- Shell installer: https://curcuma.sud.fyi/install.sh
- Welcome message: https://curcuma.sud.fyi/api/mcp/welcome-message