Skip to main content
Glama
amCharts 5 MCP Server

amCharts 5 MCP Server

Official
by amcharts

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.

Point your AI client at:

https://mcp.amcharts.com/mcp

Install in VS Code Add to Cursor

The amCharts 5 docs are also on Context7 as /amcharts/amcharts5.

Claude Code

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

Claude (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/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

Tool

Description

get_core_reference

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; full: true for the whole file

get_chart_reference

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 get_section; full: true for the whole file

list_chart_types

List all available chart types and their keywords

search_docs

Search the skill reference docs by keyword (scope: "all" adds the full docs, API reference and examples)

search_all

Search across everything — skill docs, full documentation, and code examples

get_doc

Get a full documentation page by its path (e.g. "charts/xy-chart/axes", "concepts/events") or its docs.amcharts.com address

get_section

Get a specific section from a reference file by heading (a ### subsection heading returns just that subsection)

get_quick_start

Get a minimal working template for any chart type

list_examples

Browse all 690+ examples, optionally filtered by category

get_example

Get the full code for a specific example, by its path or its amcharts.com demo address

get_api_reference

Get the API reference for a class, interface or function — settings with their defaults, events, inheritance and the import line

list_geodata

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-react package

  • "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, for list_geodata

  • Curated 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/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. 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/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/

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 tools
get_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

    A4/5.0

    Scored across 11 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers