szum MCP Server

MCP Server

Connect agents to szum via Model Context Protocol.

Model Context Protocol (MCP) is an open standard for connecting agents to tools. szum exposes an MCP server so agents can render charts, save them to permanent URLs, validate configs, and browse themes directly.

Endpoint

POST https://szum.io/mcp

No API key needed. Connect and start rendering charts immediately – up to 250 renders per month per IP, shared with keyless GET. For higher limits, add an API key:

Authorization: Bearer YOUR_API_KEY

Tools

Tool	Description	Counts as render?
render_chart	Render a chart config, returns a URL to the image (expires in 10 min)	Yes
save_chart	Save a chart config to permanent /c/{id} image + /e/{id} embed URLs (requires an API key)	No
validate_chart	Validate a config against the schema	No
list_themes	List available themes	No
list_marks	List mark types with properties	No
get_examples	Get example chart configs	No

Only render_chart increments your monthly render count; all other tools are free. save_chart requires an API key (keyless connections can render but not save) – the save itself is free, but each later view of the saved image or embed counts as one render, the same as saved charts created via the API.

Resources

URI	Description
szum://schema	Full JSON Schema for chart configs
szum://llms-txt	Compact API reference

Connect from Claude Code

claude mcp add szum --transport http https://szum.io/mcp

For higher limits, add your API key:

claude mcp add szum --transport http https://szum.io/mcp -H "Authorization: Bearer YOUR_API_KEY"

Connect from Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "szum": {
      "type": "http",
      "url": "https://szum.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "szum": {
      "type": "http",
      "url": "https://szum.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Connect from Cursor

Add this to your Cursor MCP settings (.cursor/mcp.json):

Usage and billing

Without an API key, each render_chart call counts against the IP-based limit of 250 renders per month, shared with keyless GET /chart. With an API key, renders count against your plan limit. All other tools are free.

Figma Plugin

Insert publication-ready charts straight into your Figma designs – the same charts you can render as PNG, SVG, or an interactive embed.

Authentication

GET embeds are keyless. Sign up for an API key to unlock POST requests.