dataviz
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
dataviz draws charts and returns them as PNG images you can look at. Use plot for data you have (a JSON spec of one or more panels; call chart_types for the 44 panel types and their fields), plot_file to chart a CSV/TSV/JSON file directly, and molecule for protein/DNA structures from the PDB. Look at the returned image and refine (labels, limits, chart type) when needed. Pass output with a .png/.svg/.pdf/.html path to save the chart for the user.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| plotA | Draw one or more charts from data passed inline in the call and return them as a PNG image plus a short text description of what was drawn. When to use: you already have the numbers (from the conversation, a computation or another tool). To chart a CSV/TSV/JSON file on disk use plot_file instead; for a 3D protein or DNA structure on its own, molecule is simpler (a molecule panel here is only needed to combine it with other charts). How: Behavior: draws in memory and writes nothing unless |
| plot_fileA | Chart the columns of a CSV, TSV or JSON file on disk and return a PNG image plus a text summary (columns found, what was drawn). When to use: the data is in a file the server can read, especially a large one you should not paste into a call. For data you already have in the conversation use plot, which also offers all 44 chart types; plot_file covers the common kinds below. How: give Behavior: only reads the file; writes nothing unless |
| moleculeA | Draw a protein, DNA or small molecule in 3D and return a PNG image plus a text summary. When to use: to show one structure. To put a structure next to other charts, use a molecule panel in plot instead. How: give exactly one source: pdb_id (a 4-character Protein Data Bank id such as 1UBQ), pdb_path (a local .pdb file) or pdb (the PDB text itself). The style defaults to cartoon for proteins and ball_and_stick otherwise; coloring defaults to element. rotate {x, y, z} turns the model by degrees; ramachandran adds a Ramachandran plot of the backbone angles. Behavior: pdb_id downloads the structure from files.rcsb.org (the only network access); pdb_path only reads the file; nothing is written unless |
| chart_typesA | List every panel type that plot accepts (44 types plus the grammar-of-graphics |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has an explicit, non-overlapping entry condition: plot for inline data, plot_file for data on disk, molecule for a single structure, chart_types as a pure reference. The descriptions actively cross-reference each other (e.g. 'to combine a molecule with other charts, use a molecule panel in plot'), leaving little room for misselection.
All names are snake_case and readable, but the set mixes verb-first names (plot, plot_file) with bare nouns (molecule, chart_types) rather than following a single verb_noun pattern. The plot/plot_file pair is consistent, but the overall convention is only partially applied.
Four tools is well within the ideal 3-15 range, and each one covers a distinct data source or a reference lookup. Nothing feels padded or missing at this scope.
The surface covers inline data, file-based data, molecular structures, all 44 chart types with a discovery tool, and optional output saving, so core charting workflows are closed. Minor gaps remain, such as modifying or re-reading a previously rendered image, but an agent can work around these by re-plotting.