
Official MCP server for the ChartQuery chart and QR code API.
Official MCP server for the ChartQuery chart and QR code API.
·
Official Model Context Protocol server for the ChartQuery chart and QR code API.
Generate chart images, diagrams, barcodes, QR codes and thermal labels on demand. PNG, SVG or PDF output.
It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).
ChartQuery runs this server for you at https://mcp.chartquery.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.
claude mcp add --transport http chartquery https://mcp.chartquery.com/ --header "x-api-key: YOUR_API_KEY"{
"mcpServers": {
"chartquery": {
"url": "https://mcp.chartquery.com/",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.
claude mcp add chartquery --env CHARTQUERY_API_KEY=YOUR_API_KEY -- npx -y @chartquery/mcpAdd the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):
{
"mcpServers": {
"chartquery": {
"command": "npx",
"args": ["-y", "@chartquery/mcp"],
"env": {
"CHARTQUERY_API_KEY": "YOUR_API_KEY"
}
}
}
}{
"servers": {
"chartquery": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@chartquery/mcp"],
"env": {
"CHARTQUERY_API_KEY": "${input:chartquery-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "chartquery-api-key",
"description": "ChartQuery API key",
"password": true
}
]
}Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.
docker build -t chartquery-mcp .
docker run -i --rm -e CHARTQUERY_API_KEY=YOUR_API_KEY chartquery-mcp| Tool | Description |
|---|---|
barcode | Generate a barcode image via GET. Output: SVG (default) or PNG. Supports 25+ formats: EAN-13, Code 128, ITF-14, GS1-128, postal codes and more. |
chart | Render a Chart.js image via GET. Pass the full chart object as URL-encoded JSON in query. Prefer format png for ChatGPT. POST sends the same object as a JSON body, not query. |
chart_ai | Describe a chart in plain English via GET and get a rendered image back. Powered by AI. |
chart_render | Render a previously saved chart by ID. Public, no API key required. Supports URL overrides for templates (?data1=, ?labels=, ?title=…). |
chart_view | View a previously saved chart as an interactive HTML page. Public, no API key required. Iframe-embeddable. |
diagram | Render a diagram via GET. Use type (mermaid, d2, …), query (source code), and format=png for ChatGPT. POST uses diagram_type and diagram_source instead. |
diagram_ai | Describe a diagram in plain English via GET and get a rendered image back. Powered by AI. |
diagram_render | Render a previously saved diagram by ID. Public, no API key required. Supports ?format= and ?query= overrides. |
diagram_view | View a previously saved diagram as an HTML page. Public, no API key required. Iframe-embeddable with inline SVG rendering. |
label | Preview a thermal label via GET. Pass the same label object as a URL-encoded JSON string in query. Inside that JSON, text items use content and size (1-10), not text or fontSize. Prefer format=png fo… |
label_compile | Compile a label to printer commands (tsc, zpl, epl, …). POST width, language, and elements. Text uses content and size (1-10), not text or fontSize. No barcode element. Example: {"width":40,"height":… |
label_convert | Convert printer commands from one language to another. POST source, from, and to. from is the source language (tsc, zpl, epl, …). to is the target (tsc, zpl, escpos, …). |
label_parse | Parse printer commands into structured elements. POST source and language (tsc, zpl, epl, …). |
label_render | Render a previously saved label by ID. Public, no API key required. Supports ?format= override. |
label_validate | Validate printer commands. POST source (the raw commands) and language (tsc, zpl, epl, …). |
label_view | View a previously saved label as an HTML page. Public, no API key required. Iframe-embeddable with inline SVG rendering. |
qrcode | Generate a styled QR code via GET. Output: SVG (default) or PNG. Supports dot styles, gradients, custom corners and all QR versions. |
stats | Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it. |
usage | Return this account's Chartquery usage and credit balance. No body. Requires an API key. |
Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.
npx @chartquery/mcp --http --port 3000The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.
createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):
import { createHttpHandler } from "@chartquery/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };CHARTQUERY_API_KEY (stdio) or the request headers (HTTP) and removed from error messages.npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.jsThe server uses the official Node.js SDK (@chartquery/sdk).
| SDK | Package | Install |
|---|---|---|
| Node.js | @chartquery/sdk | npm install @chartquery/sdk |
| Python | chartquery | pip install chartquery |
| Go | chartquery-go | go get github.com/chartquery/chartquery-go |
| .NET | ChartQuery | dotnet add package ChartQuery |
| Ruby | chartquery | gem install chartquery |
| PHP | chartquery/sdk | composer require chartquery/sdk |
| Java | chartquery-java | build from source, see its README |
| CLI | @chartquery/cli | npm install -g @chartquery/cli |
| MCP server | @chartquery/mcp | npx -y @chartquery/mcp |
MIT — see LICENSE.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add chartquery --transport http https://mcp.chartquery.com/{
"mcpServers": {
"chartquery": {
"url": "https://mcp.chartquery.com/",
"headers": {
"x-api-key": ""
}
}
}
}code --add-mcp '{"name":"chartquery","url":"https://mcp.chartquery.com/","headers":{"x-api-key":""}}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/chartquery-mcp-server to learn what the "ChartQuery MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --transport http chartquery https://mcp.chartquery.com/ --header "x-api-key: YOUR_API_KEY"
claude mcp add chartquery --env CHARTQUERY_API_KEY=YOUR_API_KEY -- npx -y @chartquery/mcpdocker run -i --rm -e CHARTQUERY_API_KEY=YOUR_API_KEY chartquery-mcpnpx @chartquery/mcp --http --port 3000
npx @modelcontextprotocol/inspector node dist/stdio.jsThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/chartquery-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "chartquery-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.