delete_chart
ClaudeUse 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.
Data-Analytics
Charts by Szum
by Bartosz Prusinowski
Overview
After connecting, start a new chat and say: "Use Charts by Szum to create an editorial bar chart from this data: North 42, South 35, East 28, West 31.". Charts by Szum helps Claude turn plain-language requests and raw data into publication-ready charts. It can explore curated themes and examples, validate the chart definition, and display an interactive preview with an SVG or PNG image link. When you want to keep a result, save it for permanent image and interactive embed links, then reopen, update, rename, or delete it from Claude or Szum Studio. Useful for reports, presentations, product work, and dashboards.
Tools
get_chart
ClaudeUse 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.
get_chart_config
ClaudeUse 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.
get_examples
ClaudeUse 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
ClaudeUse 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.
list_charts
ClaudeUse 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
ClaudeUse this when choosing or configuring chart mark types. Returns every available mark with its properties and defaults.
list_themes
ClaudeUse this when choosing a visual theme for a chart. Returns every available theme and guidance on where each works best.
rename_chart
ClaudeUse this when the user wants to change a saved chart's library title without changing its config, publication state, or public URLs; requires authentication.
render_chart
ClaudeUse this when the user wants to preview or generate a chart from a Szum config after preflighting a generated or materially changed config with validate_chart. Stores a one-hour preview and returns a public image URL; authenticated calls use the account's render allowance.
save_chart
ClaudeUse this when the user wants to permanently save and publish a chart from a Szum config. Returns permanent public Image and Embed URLs plus Edit and Studio links; requires authentication and saved-chart storage.
update_chart
ClaudeUse this when the user wants to replace and publish a saved chart's config while keeping its id and URLs. Refuses charts with unpublished editor changes; requires authentication and saved-chart storage.
validate_chart
ClaudeUse this when preflighting the first render, save, or update of a generated or materially changed Szum config, or when the user asks to validate or debug one. Read-only.
