szum

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 image counts against the IP-based limit of 250 renders per month, shared with keyless GET /chart (the charge lands when the returned URL is fetched and the image is actually produced). 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.