Log inSubmit server
Blueprint Chart logo

Blueprint Chart

Author, validate, inspect, render, and export interactive Blueprint Chart visualizations through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Blueprint Chart

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "blueprint-chart": {
      "command": "npx",
      "args": [
        "-y",
        "@blueprint-chart/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 11 tools correctly (8d ago).

Overview

Blueprint Chart MCP server gives AI clients tools for writing and working with Blueprint Chart .bpc files. It validates and inspects DSL, recommends chart types, renders SVG, PNG, or HTML, and exposes chart guidance, grammar, palettes, and examples. Use it when an agent needs a structured chart-authoring loop with parse diagnostics and render feedback. Optional HTTP serving, public URLs, editor links, and sandboxed file output support different deployment workflows.

Use cases

  • Author charts from structured data with an AI client
  • Validate and repair Blueprint Chart DSL
  • Choose chart types using data shape and row count
  • Render charts as SVG, PNG, or HTML
  • Export charts for editing or iframe embedding

Key features

  • Structured DSL validation diagnostics
  • Chart inspection and type recommendation
  • SVG, PNG, and HTML rendering
  • Canonical examples and grammar discovery
  • Palette and chart-type reference tools
  • Shareable and editable chart exports

Tools11

What Blueprint Chart lets your agent do. Expand a tool for its parameters.

Verified live~1.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

9/9 checks healthy over the last 45d

What it can do

From the 11 tools this server returned when we ran it; 11 declare their own safety hints.

Can delete or modify data · 1Handles credentials · 2Makes network requests · 1Read-only tools · 10
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age148 days
Maintainers1

Observed 2026-10-19 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev · @blueprint-chart/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.1kPackage downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed11Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Blueprint Chart works

What the Blueprint Chart MCP server does

The Blueprint Chart MCP server helps an AI client author and evaluate Blueprint Chart .bpc files, an open plain-text format rendered by a browser as interactive charts. Its tools cover the full path from choosing a visualization to checking syntax, reviewing structure, producing an output, and exporting a shareable result.

The server exposes eleven deterministic tools. Validation returns a validity flag, errors, warnings, error codes, messages, and suggestions. Inspection summarizes chart structure, including chart type, scenes, series and row counts, highlights, and colorization. Chart-selection tools rank suitable types from column shape and row count, while discovery tools expose chart-type documentation, grammar, palettes, and canonical samples.

How it works

An MCP client sends .bpc source or chart-discovery requests to the server. validate_dsl parses the source and reports structured diagnostics. inspect_dsl provides a compact description of the parsed chart. render produces SVG by default and can return PNG or HTML; PNG responses include an inline image and all render requests include structured frame metadata.

get_example retrieves a canonical sample by chart type or sample name. search_examples returns pointers that can be followed with get_example, and get_grammar supplies the complete DSL syntax reference. These discovery tools provide access to the same reference material exposed through the server's bpc:// resources for clients that do not support MCP resources.

With MCP_PUBLIC_URL, render and export responses can include stateless PNG, SVG, and BPC URLs, with chart data carried in the URL. export_chart also returns an editable copy URL and a read-only iframe URL when the editor URL is configured. Preview failures do not prevent export.

Setup and configuration

Run the package with npx @blueprint-chart/mcp for stdio, or add --http to serve HTTP/SSE on 127.0.0.1:4321. The repository documents configurations for Claude Desktop, Claude Code, and Cursor-compatible stdio use. Claude Code can receive BLUEPRINT_CHART_EDITOR_URL and BLUEPRINT_CHART_DOCS_URL as environment variables.

BLUEPRINT_CHART_EDITOR_URL is required by export_chart to create editor-based links. MCP_PUBLIC_URL enables public stateless URLs in render and export responses. File output is disabled unless MCP_FS_WRITE_DIR names a writable sandbox directory. When enabled, render can save output beneath that directory and creates missing subdirectories. Avoid symlinks in the sandbox if filesystem isolation matters.

Tools and capabilities

  • Validate .bpc syntax with actionable diagnostics.
  • Inspect chart structure and parsed properties.
  • Recommend chart types from data shape and row count.
  • Render SVG, PNG, or HTML, with optional inline previews.
  • Export charts with editor, iframe, and optional stateless URLs.
  • Browse chart types, grammar, palettes, guides, and examples.
  • Search canonical examples by topic or chart type.

The Blueprint Chart MCP server also exposes resources for grammar, handbook topics, usage guides, chart-type documentation, samples, and DSL or API references. A documented author_chart prompt primes an end-to-end read, write, validate, render, and iteration workflow.

Limitations and notes

Rendering dimensions are capped at 1600, and PNG output is rendered at 2× retina resolution. Inline images or previews can be suppressed with modelVisible: false. Shareable URLs are only included when MCP_PUBLIC_URL is set. Editor-based export links require BLUEPRINT_CHART_EDITOR_URL.

The server is self-contained and does not require an account or backend according to the project documentation. Disk writes require explicit configuration and are restricted by the sandbox's path handling, although symlinks can bypass lexical containment at operating-system resolution.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Blueprint Chart

Blueprint Chart is an MCP server that connects AI clients to Blueprint Chart’s .bpc chart format and rendering workflow. Its main tools validate and inspect DSL, recommend chart types, render SVG/PNG/HTML, export charts, and retrieve grammar, palettes, chart-type documentation, and canonical examples.

Run `npx @blueprint-chart/mcp` for a stdio server. Add `--http` to serve HTTP/SSE on `127.0.0.1:4321`. The documented stdio setup includes Claude Desktop, Claude Code, and Cursor.

Call `render` with `format: "png"`. The response includes an inline image, structured frame metadata, and optionally public PNG, SVG, and BPC URLs when `MCP_PUBLIC_URL` is configured.

Set `MCP_FS_WRITE_DIR` to enable sandboxed writes, then pass a `save` path to `render`. Output remains under the configured directory, missing subdirectories are created, and paths that escape through `..` traversal are rejected.

Call `export_chart` with a `.bpc` source and configure `BLUEPRINT_CHART_EDITOR_URL`. The response can include an editable copy URL, a read-only iframe URL, an inline preview, and public stateless URLs when `MCP_PUBLIC_URL` is set.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBlueprint Chart AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/blueprint-chart?style=directory)](https://allmcps.com/mcp/blueprint-chart)
HTML Embed
<a href="https://allmcps.com/mcp/blueprint-chart"><img src="https://allmcps.com/api/badge/blueprint-chart?style=directory" alt="Blueprint Chart on AllMCPs" /></a>