The amCharts 5 MCP Server gives your AI assistant on-demand access to 1,500+ documents: documentation pages, working code examples, and class API references. It queries only what it needs, keeping your context lean and your code accurate.
What is MCP?
Model Context Protocol (MCP) is an open standard that lets AI tools connect to external data sources. Instead of relying solely on training data, the AI can fetch current documentation and examples in real time. Many popular tools already support it, including Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code with GitHub Copilot.
Installation
Claude Code
Run one command to install globally (available in all projects):
claude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp
Or install for the current project only (omit -s user):
claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp
Cursor, Windsurf, Claude Desktop, and others
Add the following to your MCP configuration file:
{
"mcpServers": {
"amcharts5": {
"command": "npx",
"args": ["-y", "@amcharts/amcharts5-mcp"]
}
}
}
Where to find the config file:
| Tool | Config file | Scope |
|---|---|---|
| Cursor | .cursor/mcp.json in project root | Per project |
| Cursor (global) | ~/.cursor/mcp.json | All projects |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | Global |
| Claude Desktop | claude_desktop_config.json | Global |
VS Code + GitHub Copilot
VS Code uses a slightly different format. 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 Cline, Continue, Amazon Q, Zed, and other tools that support MCP, configure them to run:
npx -y @amcharts/amcharts5-mcp
Check your tool's documentation for the exact config format.
Available tools
Once installed, the AI gets access to 10 tools for querying amCharts documentation:
| Tool | What it does |
|---|---|
get_core_reference | Core amCharts 5 docs - setup, themes, colors, events, common pitfalls |
get_chart_reference | Full reference for a chart type (e.g. "pie", "sankey", "treemap") |
list_chart_types | List all available chart types and their keywords |
search_docs | Search the skill reference docs by keyword |
search_all | Search across everything - docs, examples, and API reference |
get_doc | Get a full documentation page (e.g. "charts/xy-chart/axes") |
get_section | Get a specific section from a reference file by heading |
get_quick_start | Get a minimal working template for any chart type |
list_examples | Browse all 283 examples, optionally filtered by category |
get_example | Get the full code for a specific example |
You don't need to call these tools yourself. The AI decides which tools to use based on your request and fetches the relevant information automatically.