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/mcpNo 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_KEYTools
| 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/mcpFor 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"
}
}
}For higher limits, add your API key:
{
"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):
{
"mcpServers": {
"szum": {
"type": "http",
"url": "https://szum.io/mcp"
}
}
}For higher limits, add your API key:
{
"mcpServers": {
"szum": {
"type": "http",
"url": "https://szum.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}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.