# @chartone/mcp

> Branded chart rendering for AI agents. Hosted MCP, zero setup.

ChartOne MCP gives any AI agent the ability to produce themed charts and return them as both an inline image and a persistent hosted URL — perfect for emails, Slack messages, PDFs, and dashboards.

## Install

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "chartone": {
      "command": "npx",
      "args": ["-y", "@chartone/mcp"],
      "env": {
        "CHARTONE_API_KEY": "sk-..."
      }
    }
  }
}
```

Restart Claude Desktop. Anonymous mode (no key) returns watermarked charts.

### Cursor / Zed / Windsurf

Same config shape, in each client's MCP settings file. See [docs.chartone.dev/mcp](https://docs.chartone.dev/mcp) for current paths.

### Hosted endpoint (beta)

For cloud agents that can't run local stdio servers:

```text
POST https://api.chartone.dev/mcp
Authorization: Bearer sk-...   (optional, anonymous returns watermark)
Content-Type: application/json

Body: { "method": "tools/list" }  or  { "method": "tools/call", "params": {...} }
```

## Tools

- **`render_chart`** — render a chart from explicit type, data, theme.
- **`suggest_chart`** — give it data + intent ("show quarterly trends"), it picks the chart type/theme and renders.

Both return an inline image plus a persistent hosted URL.

## Get an API key

Sign up at [chartone.dev](https://chartone.dev). Free tier includes a generous render quota; paid tiers remove the watermark and extend URL lifetime.