mcp server

Charts by Szum

Create, inspect, manage, and render charts and data visualizations as SVG/PNG or interactive embeds.

Description as published by the maintainer. Source

• version 1.4.0
• active

active — Registry entry last updated 2026-08-05.

What this server can do

13 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

delete_chart(id)

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. Required: id.

get_chart(id)

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 config; requires authentication. Required: id.

get_chart_config(id)

Use this when the user identifies a saved chart by id and needs its complete published Szum config for inspection or reuse. Does not return a newer editor draft; requires authentication. Required: id.

get_examples(mark_type)

Use this when the model needs current, ready-to-use Szum chart configs or preferred semantic patterns. Optionally filters examples by mark type.

get_preview_state(previewId)

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. Required: previewId.

list_charts(q, sort, limit, cursor, source)

Use this when the user wants to find charts in their saved library. Returns paginated metadata and URLs, not chart configs; requires authentication. Draft-only editor charts have publishedAt null, hasDraft true, and sizeBytes 0 because sizeBytes measures only the stored published config, not draft storage.

list_marks

Use this when choosing or configuring chart mark types. Returns every available mark with its properties and defaults.

list_themes

Use this when choosing a visual theme for a chart. Returns every available theme and guidance on where each works best.

rename_chart(id, title)

Use this when the user wants to change a saved chart's library title without changing its config, publication state, or public URLs; requires authentication. Required: id, title.

render_chart(config, acknowledgeWarnings)

Use this when the user wants to preview or generate a chart. Validate each generated or changed config once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors block; warnings require explicit user approval for the exact config. Suggestions do not block. Replace the complete config with suggestedConfig and revalidate before repair. Stores a 1 hour preview and returns public image URLs. Authenticated previews use the account's render allowance, and each image produced from a returned URL is another render. Anonymous previews are complimentary; their images use the anonymous image allowance. Required: config.

save_chart(config, idempotencyKey, acknowledgeWarnings)

Use this when the user wants to permanently save and publish a chart from a Szum config. Validate each generated or changed config once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors block; warnings require explicit user approval for the exact config. Suggestions do not block. Replace the complete config with suggestedConfig and revalidate before repair. Supply one idempotencyKey per intended chart and reuse it for retries. Returns permanent public Image and Embed URLs plus Edit and Studio links; requires authentication and saved-chart storage. Required: config.

update_chart(id, config, acknowledgeWarnings)

Use this when the user wants to replace and publish a saved chart's config while keeping its id and URLs. Validate each generated or changed config once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors block; warnings require explicit user approval for the exact config. Suggestions do not block. Replace the complete config with suggestedConfig and revalidate before repair. Refuses charts with unpublished editor changes; requires authentication and saved-chart storage. Required: id, config.

validate_chart(config)

Use this when a chart config will be rendered, saved, or updated. Validate each generated or changed config once before rendering, saving, or updating. Do not revalidate unchanged input; a successful render preflights it for later saves or updates. Errors block; warnings require explicit user approval for the exact config. Suggestions do not block. Replace the complete config with suggestedConfig and revalidate before repair. Read-only, free, and fast. Required: config.

Last successful function declaration observed on 2026-08-13. Source: https://szum.io/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://szum.io/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Website — https://szum.io
• Remote endpoint (streamable-http) — https://szum.io/mcp