amCharts 5 MCP Server
OfficialAn MCP server that gives AI assistants on-demand access to the complete amCharts 5 knowledge base — 160+ docs pages, 690+ code examples, 1,300+ API reference pages and 670+ geodata entries — so they can look up exactly what they need instead of loading everything into context.
Discover chart types — list all chart types with categories and reference file names.
Read chart references — get the full reference for a chart type (pie, sankey, xy, treemap, map, radar, stock, gantt, venn, wordcloud, timeline, flow, hierarchy, UI elements).
Get the core reference — setup, colors, themes, legends, tooltips, events, data, adapters, disposal and common pitfalls.
Search — keyword search the curated skill docs, or search across everything (skill docs, full documentation and code examples).
Fetch docs — get a full documentation page by path (e.g.
concepts/events,getting-started/integrations/react) or a single section by heading.Get quick-start templates — minimal working examples per chart type, as a full HTML page or ES module imports.
Look up API reference — per-class settings with real defaults, methods, events, inheritance and import line, optionally including private settings.
Browse and read examples — list 690+ examples by category and get the full code for any demo.
Find map data — list geodata files (world, continents, countries, regional packs, US congressional districts) with CDN paths, script globals and ES imports.
Work anywhere — hosted at
https://mcp.amcharts.com/mcp(no install, no auth) or locally vianpx @amcharts/amcharts5-mcp; read-only, no writes or network fetches.
Provides framework-specific documentation and integration guides for implementing amCharts 5 visualizations within Angular applications.
Provides framework-specific documentation and integration guides for implementing amCharts 5 visualizations within Next.js applications.
Provides framework-specific documentation and integration guides for implementing amCharts 5 visualizations within React applications.
Provides framework-specific documentation and integration guides for implementing amCharts 5 visualizations within Svelte applications.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
amCharts 5 MCP Server
Using Claude? Install the amCharts 5 plugin: it bundles this server and the skill. In Claude Code:
/plugin install amcharts5@anthropic-plugin-directory.Using ChatGPT? Install the amCharts 5 plugin: it bundles this server and the skill.
An MCP (Model Context Protocol) server that gives AI assistants on-demand access to the complete amCharts 5 knowledge base: 160+ documentation pages, 690+ code examples (including 60+ complete JSON configs and 330+ demos from the docs pages), 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.
Related MCP server: Dedalus MCP Documentation Server
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
The amCharts 5 docs are also on Context7 as /amcharts/amcharts5.
Claude Code
claude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcpClaude (claude.ai, Desktop) — add amCharts 5 from the Connectors Directory. Or 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 — install the amCharts 5 plugin, which bundles this server and the skill. To add the server yourself (also on the Free plan), open Plugins → + → Add custom MCP server. Name it amCharts, set the URL to https://mcp.amcharts.com/mcp and Authentication to No authentication, then Create as a plugin. In a chat, type @amCharts to use it.
Figma Make and the Figma agent (paid Figma plans) — in the chat, open Add context → Connectors → Manage → Create. Name it amCharts, set the URL to https://mcp.amcharts.com/mcp with no authentication, and set its tools to Always run. Then name amCharts in the prompt (Make picks Recharts otherwise), e.g. "Build a sales dashboard with amCharts: a world map colored by revenue and a line chart of monthly sales". Make installs @amcharts/amcharts5 and looks up the code through the server. A pasted amcharts.com demo or docs link works as context too.
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/mcpFor 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-mcpFor current project only:
claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcpClaude 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-mcpRun locally (for development)
git clone https://github.com/amcharts/amcharts5-mcp.git
cd amcharts5-mcp
npm install
npm startAvailable Tools
Tool | Description |
| Get core amCharts 5 docs — setup, themes, colors, events, common pitfalls. An overview: its first sections, up to 12,000 characters, and a list of the others; |
| Get the reference for a chart type (e.g. "pie", "sankey", "xy"). One longer than 12,000 characters comes as an overview with the rest listed for |
| List all available chart types and their keywords |
| Search the skill reference docs by keyword ( |
| Search across everything — skill docs, full documentation, and code examples |
| Get a full documentation page by its path (e.g. "charts/xy-chart/axes", "concepts/events") or its docs.amcharts.com address |
| Get a specific section from a reference file by heading (a |
| Get a minimal working template for any chart type |
| Browse all 690+ examples, optionally filtered by category |
| Get the full code for a specific example, by its path or its amcharts.com demo address |
| Get the API reference for a class, interface or function — settings with their defaults, events, inheritance and the import line |
| Find map (geodata) files — world, continents, countries, regional packs and the per-Congress US congressional district packs — with each file's CDN path (and its jsDelivr or unpkg address, for pages limited to npm CDNs), script global and ES import |
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"), which covers the@amcharts/amcharts5-reactpackage"What chart types are available?" → AI calls
list_chart_types()"Map the current US congressional districts" → AI calls
list_geodata("congressional whole country")A pasted amcharts.com link, e.g. "make one like https://www.amcharts.com/demos/sankey-diagram/" → whichever tool the AI tries with it (a search,
get_doc,get_example) points to the call that returns that demo's code or that docs page or section
Content
The server includes 2,200+ documents:
160+ documentation pages — getting started, chart guides, concepts (themes, events, adapters, data binding, animations, accessibility, etc.), and framework integration guides for amCharts' React, Vue, Angular, Svelte and React Native packages (with Next.js, Nuxt, SvelteKit, React Router and Remix 3)
690+ code examples — 300+ working demos across 16 categories including column/bar, line/area, pie/donut, maps, hierarchy, flow, radar/polar, stock, gauges, Gantt, timeline, and more, plus 60+ complete JSON configs from the amCharts npm package and 330+ demos embedded in the docs pages (each page links its demos)
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), methods, events, properties, data item fields, the inheritance chain and the import line
670+ geodata entries — every map in
@amcharts/amcharts5-geodata, forlist_geodataCurated skill reference — quick-start templates, chart-specific guides and a guide to writing JSON configs, 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/mcpserves 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. It is deleted when the session ends, or 24 hours after its last request.
Per-request logs (Workers invocation logs) are off. Only error messages are logged, and they hold no tool arguments. See "Privacy" below.
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/sdkandzod.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/
Privacy
Neither the hosted server nor the npm package needs an account or asks for personal data.
Hosted server (
https://mcp.amcharts.com/mcp):What your AI app sends: a search phrase, a chart type, a doc path. These are used only to build the answer, and are not logged or stored. A response is kept in the session's storage only until it has been delivered (so a dropped stream can resume), then deleted.
Session record: when an AI app connects, the server keeps its MCP initialize message in the session's storage. That message holds what the app says about itself (its name and version, and whatever else it puts there), the protocol version and the app's MCP capabilities. All of the session's storage is deleted when the app ends the session, or 24 hours after its last request.
Logs: the server keeps no request logs (Workers invocation logs are off). It runs on Cloudflare Workers, and Cloudflare processes each request, including its IP address, to deliver it. Error and warning messages are logged and kept for up to 7 days; they hold no request contents or tool arguments.
npm package: it runs on your computer over stdio and sends nothing to amCharts or anyone else.
Policy and questions: see the amCharts privacy policy, or write to contact@amcharts.com.
License
MIT
Available Tools
11 toolsget_api_referenceAInspect
Get the per-class API reference for an amCharts 5 class — the class page PLUS its settings table (with DEFAULTS) and, optionally, its private/read-only settings. This is the authoritative source for exact setting names and default values (e.g. tooltip background cornerRadius, axis tick visible default). Pass a class name in any casing, e.g. 'XYCursor', 'Tooltip', 'PieSeries', 'AxisRendererX'.
Inputs: className (required), includePrivate.
get_chart_referenceAInspect
Get the full reference documentation for a specific amCharts 5 chart type. Use list_chart_types first to see available types.
Inputs: chartType (required).
get_core_referenceAInspect
Get the core amCharts 5 reference (SKILL.md) — covers setup, colors, themes, legends, tooltips, events, data, adapters, disposal, and common pitfalls. Read this first before any chart-specific reference.
Inputs: no named parameters.
get_docAInspect
Get a full documentation page — an extended doc by path, or a skill file by 'skill/'. Accepts the source label exactly as search_docs / search_all print it. Use search_all first to find the right path.
Inputs: path (required).
get_exampleAInspect
Get the full code for a specific amCharts 5 example/demo. Use list_examples or search_all to find the path.
Inputs: path (required).
get_quick_startAInspect
Get a quick-start template for a specific chart type — a minimal working example ready to customize.
Inputs: chartType (required), format.
get_sectionAInspect
Get the FULL text of one section of a doc by heading — use it to expand a truncated search_docs / search_all result. file accepts the source label exactly as search results print it ('skill/SKILL.md', 'skill/xy', 'extended/charts/xy-chart/cursor', 'reference/xycursor') as well as a bare skill file name ('SKILL', 'xy', 'map').
Inputs: file (required), heading (required).
list_chart_typesAInspect
List all amCharts 5 chart types with their categories and reference file names
Inputs: no named parameters.
list_examplesAInspect
List all available amCharts 5 code examples, optionally filtered by category.
Inputs: category.
search_allAInspect
Search across ALL amCharts 5 content: skill references, full documentation, and code examples. Use this for broad searches across everything.
Inputs: query (required), maxResults.
search_docsAInspect
Search the curated amCharts 5 skill docs (SKILL.md + chart references) for a keyword or topic, returning matching sections ranked by relevance. NOTE: by default this scans ONLY the skill layer. The per-class API reference and per-setting DEFAULTS (e.g. tooltip background cornerRadius, axis tick visible default, cursor line strokeDasharray) live in the extended docs — pass scope:'all' here, or use search_all / get_api_reference / get_doc, to reach them.
Inputs: query (required), scope, maxResults.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a fairly distinct retrieval target (search, full doc, API reference, examples, chart types, sections), but there is real overlap: search_all vs search_docs (which can scope:'all') and get_doc vs get_section vs get_core_reference all fetch documentation content. The detailed descriptions do a good job steering the agent, keeping confusion to a couple of edge pairs.
Names follow a clean, predictable verb_noun pattern: search_all/search_docs, get_doc/get_section/get_example/get_api_reference, list_examples/list_chart_types. No mixed conventions or vague verbs.
11 tools is well-scoped for a documentation/reference server, with each tool earning its place across discovery (search, list) and retrieval (get) roles. Neither bloated nor thin.
The surface covers the full documentation workflow: broad and scoped search, full docs, per-class API references with defaults, examples, chart-type listings, core skill reference, and quick-start templates. No obvious dead ends for an agent exploring amCharts 5.
Maintenance
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
An MCP server that gives your AI access to the source code and docs of all public github repos
MCP server for agentverse documentation, generated by doc2mcp.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to access up-to-date documentation for Python libraries like LangChain, LlamaIndex, and OpenAI through dynamic fetching from official sources.1MIT
- AlicenseAqualityDmaintenanceAn MCP server that serves documentation and enables AI-powered search, Q\&A, and document analysis for developer tools and guides.54MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.10 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI coding assistants access to up-to-date API documentation via RAG by crawling documentation sites, indexing them into a vector store, and enabling semantic queries.MIT