
Charts by Szum
Turns JSON configs into chart images through szum.io's rendering API. You pass a flat JSON object with marks (barY, line, dot, areaY, etc.), data arrays, and optional theme properties, and get back SVG or PNG output. The config format is deliberately simple with obvious field names, which makes it easy for Claude to generate correct charts without much prompting. Useful when you want visual output during analysis sessions instead of just describing trends in text. Supports composable marks so you can layer multiple chart types, and includes six preset themes (modern, editorial, dark, neon, pastel, technical) that you can customize. Works over streamable HTTP so charts render progressively as Claude generates the config.
- tools
- 16
- transport
- HTTP
- last updated
- Nov 2, 2026
Install
From registry metadata$ npx add-mcp https://szum.io/mcp --name chartsRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http charts https://szum.io/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 16 toolsVerified live against the running server on Nov 6, 2026.
render_chartUse this when the user wants to preview or generate a chart. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors block; warnings requi...3 params
Use this when the user wants to preview or generate a chart. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors block; warnings requi...
acknowledgeWarningsbooleanrequest*stringsharedThemestringsave_chartUse this when the user wants to permanently save and publish a Szum chart document. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Error...5 params
Use this when the user wants to permanently save and publish a Szum chart document. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Error...
acceptLossesarrayacknowledgeWarningsbooleandocument*stringidempotencyKeystringsharedThemestringlist_chartsUse this when the user wants to find charts in their saved library. Returns paginated metadata and URLs, not chart documents; requires authentication. Draft-only editor charts have publishedAt null, hasDraft true, and sizeBytes 0 because sizeBytes measures only the stored publ...6 params
Use this when the user wants to find charts in their saved library. Returns paginated metadata and URLs, not chart documents; requires authentication. Draft-only editor charts have publishedAt null, hasDraft true, and sizeBytes 0 because sizeBytes measures only the stored publ...
authorstringcursorstringlimitintegerqstringsortstringupdated · created · titlesourcevalueget_chartUse this when the user identifies a saved chart by id and wants to view it or retrieve its metadata and URLs. Displays the published chart when available and does not return its document; requires authentication.1 params
Use this when the user identifies a saved chart by id and wants to view it or retrieve its metadata and URLs. Displays the published chart when available and does not return its document; requires authentication.
id*stringget_chart_documentUse this when the user identifies a saved chart by id and needs its complete published Szum document for inspection or reuse, or an earlier version's document from list_chart_versions. Does not return a newer editor draft; requires authentication.2 params
Use this when the user identifies a saved chart by id and needs its complete published Szum document for inspection or reuse, or an earlier version's document from list_chart_versions. Does not return a newer editor draft; requires authentication.
id*stringversionintegerlist_chart_versionsUse this when the user wants to see a saved chart's earlier publications, find one to read with get_chart_document, or pick one to restore with restore_chart_version. Returns versions newest first with who published each, from where and what changed; requires authentication.4 params
Use this when the user wants to see a saved chart's earlier publications, find one to read with get_chart_document, or pick one to restore with restore_chart_version. Returns versions newest first with who published each, from where and what changed; requires authentication.
cursorstringid*stringlimitintegernamedbooleanget_preview_stateUse this when the Szum chart App needs to restore a rendered preview as its current transient or saved view. It is read-only, owner-scoped when authenticated, and hidden from the model.1 params
Use this when the Szum chart App needs to restore a rendered preview as its current transient or saved view. It is read-only, owner-scoped when authenticated, and hidden from the model.
previewId*stringupdate_chartUse this when the user wants to replace and publish a saved chart's document while keeping its id and URLs. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later...6 params
Use this when the user wants to replace and publish a saved chart's document while keeping its id and URLs. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later...
acceptLossesarrayacknowledgeWarningsbooleandocument*stringid*stringsharedThemevaluetitlestringrestore_chart_versionUse this when the user wants a saved chart to go back to an earlier version from list_chart_versions. Publishes that version's document again as a new version, keeping the chart's id and URLs, so the version it replaces stays restorable. Refuses charts with unpublished editor...3 params
Use this when the user wants a saved chart to go back to an earlier version from list_chart_versions. Publishes that version's document again as a new version, keeping the chart's id and URLs, so the version it replaces stays restorable. Refuses charts with unpublished editor...
acceptLossesarrayid*stringversion*integerrename_chartUse this when the user wants to change a saved chart's library title without changing its document, publication state, or public URLs; requires authentication.2 params
Use this when the user wants to change a saved chart's library title without changing its document, publication state, or public URLs; requires authentication.
id*stringtitle*stringdelete_chartUse this when the user explicitly wants to permanently delete one saved chart. Deletion cannot be undone, and retrying an already completed deletion succeeds; requires authentication.1 params
Use this when the user explicitly wants to permanently delete one saved chart. Deletion cannot be undone, and retrying an already completed deletion succeeds; requires authentication.
id*stringlist_themesUse this when choosing a visual theme for a chart. Returns every built-in theme with guidance on where each works best and, when signed in, the workspace's shared themes.
Use this when choosing a visual theme for a chart. Returns every built-in theme with guidance on where each works best and, when signed in, the workspace's shared themes.
No parameters. Call it with no arguments.
validate_chartUse this when a chart request or document will be rendered, saved, or updated. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors blo...1 params
Use this when a chart request or document will be rendered, saved, or updated. Validate each generated or changed chart input once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors blo...
chart*stringlist_chart_typesUse this when choosing a chart family. Returns every current chart type with its shared and family-specific fields.
Use this when choosing a chart family. Returns every current chart type with its shared and family-specific fields.
No parameters. Call it with no arguments.
get_examplesGet complete Szum documents for validation, rendering, or saving, with guidance on when to use each pattern. No filters returns one starter per chart type. Any filter searches the complete catalog; all supplied filters intersect. Most data is illustrative; the Vinyl waterfall...4 params
Get complete Szum documents for validation, rendering, or saving, with guidance on when to use each pattern. No filters returns one starter per chart type. Any filter searches the complete catalog; all supplied filters intersect. Most data is illustrative; the Vinyl waterfall...
chart_typestringcolumn · bar · line · area · scatter · pieexample_idstringfeaturesarraypurposestringcomparison · change · trend · composition · relationship · distributionget_schemaUse this before authoring an unfamiliar field instead of probing validate_chart for errors. Returns the JSON Schema for the whole Szum document, covering config, data, presentation, size, and output, with every referenced definition included. Pass chart_type to keep only that...1 params
Use this before authoring an unfamiliar field instead of probing validate_chart for errors. Returns the JSON Schema for the whole Szum document, covering config, data, presentation, size, and output, with every referenced definition included. Pass chart_type to keep only that...
chart_typestringcolumn · bar · line · area · scatter · pieSponsors
Details
- Website
- szum.io
- Categories
- Design & Creative, Data & Analytics
- Transport
- HTTP
- Registry
- MCP registry, active
- Resources
- 3
- Tools verified
- Nov 6, 2026