amCharts 5 MCP Server

An MCP (Model Context Protocol) server that gives AI assistants on-demand access to the complete amCharts 5 knowledge base: 160+ documentation pages, 290+ code examples, and 1,300+ API reference pages.

Works with Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + GitHub Copilot, and any other MCP-compatible AI tool.

Why?

Instead of loading the entire amCharts reference into the AI's context window, the MCP server lets the AI query exactly what it needs — a specific chart type reference, a code example, or an API lookup. This means better answers with less context waste.

Quick Start

The easiest way is the hosted server — no install, just add one URL. Prefer to run it yourself? See Local install below.

Hosted (no install) — recommended

Point your AI client at:

https://mcp.amcharts.com/mcp

Claude Code

claude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcp

Claude Desktop / claude.ai — Settings → Connectors → Add custom connector, then paste https://mcp.amcharts.com/mcp.

Cursor — .cursor/mcp.json:

{
  "mcpServers": {
    "amcharts5": {
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

VS Code + GitHub Copilot — .vscode/mcp.json:

{
  "servers": {
    "amcharts5": {
      "type": "http",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "serverUrl": "https://mcp.amcharts.com/mcp"
    }
  }
}

ChatGPT (Plus/Pro/Enterprise with connectors/developer mode enabled) — Settings → Connectors → Add custom connector, then paste https://mcp.amcharts.com/mcp.

Cline (VS Code extension) — open the MCP Servers panel → Remote Servers, paste https://mcp.amcharts.com/mcp, or add to its MCP settings JSON:

{
  "mcpServers": {
    "amcharts5": {
      "type": "streamableHttp",
      "url": "https://mcp.amcharts.com/mcp"
    }
  }
}

Clients that only support local (stdio) servers (e.g. Zed, Continue, Amazon Q Developer) — bridge to the hosted URL with mcp-remote. Use this as the server's run command in the client's config:

npx mcp-remote https://mcp.amcharts.com/mcp

For example, in a command/args style config:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.amcharts.com/mcp"]
    }
  }
}

Any other MCP client that accepts a remote server URL works too — use the /mcp endpoint (Streamable HTTP) or /sse (legacy SSE). For URL-only clients that still expect a command, use the mcp-remote bridge shown above.

Local install (npx)

Prefer running it yourself? The server is also published to npm and runs over stdio.

Claude Code

For all projects (global, recommended):

claude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp

For current project only:

claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Cursor

Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "amcharts5": {
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

VS Code + GitHub Copilot

Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "amcharts5": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@amcharts/amcharts5-mcp"]
    }
  }
}

Other MCP-compatible tools

For any other tool that supports MCP (Cline, Continue, Amazon Q, Zed, etc.), configure it to run:

npx -y @amcharts/amcharts5-mcp

Run locally (for development)

git clone https://github.com/amcharts/amcharts5-mcp.git
cd amcharts5-mcp
npm install
npm start

Available Tools

Example Usage

Once connected, your AI assistant can:

• "Build me a pie chart" → AI calls get_quick_start("pie") and adapts the template
• "How do I format date axis labels?" → AI calls search_all("date axis label format")
• "Show me the Sankey diagram example" → AI calls get_example("examples/flow/sankey-diagram")
• "What settings does XYChart support?" → AI calls get_doc("reference/xychart")
• "How do I integrate with React?" → AI calls get_doc("getting-started/integrations/react")
• "What chart types are available?" → AI calls list_chart_types()

Content

The server includes 1,800+ documents:

• 160+ documentation pages — getting started, chart guides, concepts (themes, events, adapters, data binding, animations, accessibility, etc.), and framework integration guides (React, Angular, Vue, Next.js, Svelte, and more)
• 290+ code examples — working demos across 16 categories including column/bar, line/area, pie/donut, maps, hierarchy, flow, radar/polar, stock, gauges, Gantt, timeline, and more
• 1,300+ API reference pages — every class, interface and function in the amCharts 5 library, generated from the release's typings: settings with their real defaults (theme rules included), events, properties, data item fields, the inheritance chain and the import line
• Curated skill reference — quick-start templates and chart-specific guides from the amCharts 5 AI Skill

Security

• Read-only tools. Every tool reads the bundled amCharts documentation and returns text. No tool writes files, runs commands or fetches URLs.
• The hosted endpoint has no authentication, by design. https://mcp.amcharts.com/mcp serves the same public documentation as amcharts.com. There are no accounts, API keys, user data or write operations behind it.
  • It runs on Cloudflare Workers.
  • MCP session state is kept in a Durable Object, as the MCP agents framework requires.
  • Cloudflare's standard request logs are enabled. The server itself does not log tool arguments.
• Local install. The npm package runs over stdio on your machine and reads only the content bundled in it; it makes no network requests. Its only runtime dependencies are @modelcontextprotocol/sdk and zod.
• Maintainer scripts. The scripts in scripts/ (the demo and docs scrapers, the API reference generator) are not part of the npm package and never run in the server.
• Reporting a vulnerability: https://www.amcharts.com/report-vulnerability/

License

MIT