# Curcuma — Cursor setup

## Mint a free token

```bash
curl -fsS -X POST https://curcuma.sud.fyi/api/mcp/install-token
```

Save the `token` field. Do not commit it to git.

## Cursor MCP config

Create or merge `~/.cursor/mcp.json` (or project `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "curcuma": {
      "type": "http",
      "url": "https://curcuma.sud.fyi/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}
```

If your Cursor build expects `url` without `type`, keep the same URL and headers shape Cursor documents for Streamable HTTP.

Reload Cursor (Command Palette → “MCP: Restart” or full reload) so tools appear.

## Skills (optional)

Install the public skill pack for routing email work:

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

Or copy skills from the monorepo `skills/` into your Cursor skills root.

Canonical skill URL:

https://curcuma.sud.fyi/.well-known/agent-skills/curcuma/SKILL.md

## Verify

1. MCP tools list includes `search_emails` and `get_email_summary`.
2. Prompt: *Design a welcome email. Use Curcuma: search welcome, study 2–3 with get_email_summary, output HTML.*

## Agent handoff

`https://curcuma.sud.fyi/agent/<token>`