semiotic
io.github.nteract/semiotic · version 3.13.3 · 11,771 weekly npm downloads · audited 2026-11-03
Notes
Findings
No hidden-instruction or invisible-character findings in any tool, prompt, or resource description.
Claude Connectors Directory readiness
- ❌ Every tool has a title Missing on 16 of 24: getSchema, suggestChart, renderChart, diagnoseConfig and 12 more
- ✅ Every tool declares readOnlyHint or destructiveHint 24 of 24 tools
- ✅ Tool names are 64 characters or fewer All within limit
- ❌ Descriptions avoid instructions about model behavior or other tools 7 of 24 descriptions reference other tools or tell the model what it must do: getSchema, suggestChart, renderInteractiveChart, diagnoseConfig and 3 more
- ✅ No hidden instructions or invisible characters in tool metadata None found
Checks the directory's published tool requirements that are visible from tools/list. Passing them does not guarantee acceptance.
Supply chain
- Install scripts: none
- npm provenance: yes
- Source repository linked: yes
- License: Apache-2.0
- Direct dependencies: 13
Tools (24)
| Name | Title | Hint | Description |
|---|---|---|---|
auditArtifact | Audit an explicit artifact contract | read-only | Evaluate a chart and its explicit artifact contract under a named policy. The tool audits only supplied claims, evidence, source identity, review state, and time state; missing facts remain missing or unknown. Results ar… |
recommendRepresentation | Recommend a defensible representation | read-only | Recommend chart and non-chart outcomes from explicit data and an explicit artifact contract. Evidence, source, review, and time facts are never synthesized. The named policy can recommend waiting, collecting data, or mak… |
repairArtifact | Repair an explicit artifact contract | read-only | Propose repairs for a chart and explicit artifact contract. By default this is proposal-only. If enabled, safe application fills missing component and configuration/data identity fields only; existing bindings are never … |
explainRefusal | Explain an artifact policy refusal | read-only | Evaluate an explicit artifact contract under a named policy and explain why publication or action is refused. Missing evidence, source, review, and time facts stay explicit rather than being guessed. |
getSchema | read-only | Return the prop schema for a Semiotic chart component. Pass { component: '<name>' } to get its props, or omit component to list all available components. Components marked [renderable] can be passed to renderChart for st… | |
suggestChart | read-only | Lightweight heuristic chart recommender for a small data sample (1-5 rows) with capability filtering (push API, linked hover, SSR, selection, legend). Returns ranked recommendations with example props. For richer capabil… | |
renderChart | read-only | Render a Semiotic chart to static SVG or PNG. This is a static snapshot path: props must include data immediately, and ref/push-mode charts cannot be rendered through this tool. Returns SVG text by default or an image/pn… | |
renderInteractiveChart | Render interactive Semiotic chart | read-only | Render a static-data Semiotic chart as a ChatGPT Apps widget. Use this after suggestCharts/getSchema/diagnoseConfig when the user wants to see an interactive chart inside ChatGPT. The server renders Semiotic to SVG and t… |
diagnoseConfig | read-only | Diagnose a Semiotic chart configuration for common problems (empty data, bad dimensions, missing accessors, wrong data shape, color contrast issues, etc). Pass usageMode='push' for ref-based React HOCs that intentionally… | |
auditAccessibility | read-only | Audit a Semiotic chart configuration against the Chartability (POUR-CAF) accessibility framework — Perceivable, Operable, Understandable, Robust, Compromising, Assistive, Flexible. Statically grades the config (no DOM/AT… | |
evaluateChart | read-only | Evaluate a Semiotic chart through one deterministic quality pass: numeric data contracts, configuration and representation/deception checks, and static Chartability accessibility heuristics. Returns the independent audit… | |
auditMobileVisualization | read-only | Audit a Semiotic chart configuration for mobile visualization risks. Use before generating phone-sized charts or when adapting a desktop chart to mobile. Flags fixed desktop widths, rough mark-density overload, hover-onl… | |
reportIssue | read-only | Generate a GitHub issue URL for Semiotic bug reports or feature requests. Returns a URL the user can open to submit. For rendering bugs, include the component name, props summary, and any diagnoseConfig output in the bod… | |
applyTheme | read-only | Get usage instructions for a named Semiotic theme preset. Returns ThemeProvider examples, CSS custom properties, and design token export patterns. Available themes: light, dark, high-contrast, pastels, pastels-dark, bi-t… | |
interrogateChart | read-only | Conversational interrogation of a Semiotic chart. Extract a statistical summary and answer natural language questions about the data, trends, and outliers. Returns a summary and guidance for an AI to generate a textual a… | |
groundChart | Ground a Semiotic chart for a non-visual reader | read-only | Build the agent-reader grounding payload for a Semiotic chart: the layered L1–L3 natural-language description, the L4 communicative-act sentence (what the chart is asking the reader to do), and a structured navigation tr… |
suggestStreamCharts | read-only | Recommend streaming Semiotic charts for a schema (not row data). Pass fields (with optional cardinality and additive hints) plus optional throughput (band or rows/sec), retention, shape ('append'|'keyed'|'aggregate'), an… | |
suggestStreamDashboard | read-only | Compose a multi-panel dashboard from one or more stream schemas. Honors AudienceProfile.dashboard layout policy (cellBudget, leadFamilies, windowPreference). | |
suggestDashboard | read-only | Generate a dashboard of complementary chart panels for a dataset — each panel answers a distinct analytical intent (trend, rank, distribution, correlation, etc.) and the engine diversifies by chart family by default. Heu… | |
suggestTokenEncoding | read-only | Recommend a semantic token / ISOTYPE encoding for a reader task. Use before drawing repeated dots, icons, glyphs, natural-frequency grids, quantile dotplots, or hybrid bar-token views. Returns the recommended tokenEncodi… | |
suggestStretchCharts | read-only | Recommend literacy-growth chart picks for a dataset given an AudienceProfile. Returns charts the data supports but the audience is unfamiliar with (familiarity ≤ 3, or ≤ 4 at exposureLevel 2), each paired with the famili… | |
repairChartConfig | Repair an unsuitable chart choice | read-only | Validate that a chart component is a sensible choice for a dataset, and if not, propose ranked alternatives that fit. Returns a structured status of ok, alternative, or unknown. |
proposeChartVariants | read-only | Propose and score chart variants for a selected Semiotic component. Uses the capability registry plus heuristic variant discovery: registered variants, conservative transforms, and same-intent cross-family alternatives. … | |
suggestCharts | Recommend Semiotic charts | read-only | Recommend Semiotic charts for a dataset using heuristic capability descriptors. Returns ranked, structured suggestions with scores, reasons, caveats, and ready-to-use props; no LLM call is made. |
Check your own setup
npx mcpvetter scan --liveBadge
Add this to a README:
[](https://mcpvetter.com/servers/semiotic)Publish this server?
Get the MCPVetter verified badge, a re-audit within 24 hours of every npm release, and an email whenever tools, findings, or Claude directory readiness change. $29 per server per month. You prove ownership first, free.