{
  "markdown": "# amCharts 5 MCP Server\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants on-demand access to the complete amCharts 5 knowledge base: **140+ documentation pages**, **280+ code examples**, and **1,000+ class API references**.\n\nWorks with **Claude Code**, **Claude Desktop**, **Cursor**, **Windsurf**, **VS Code + GitHub Copilot**, and any other MCP-compatible AI tool.\n\n## Why?\n\nInstead 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.\n\n## Quick Start\n\nThe easiest way is the **hosted server** — no install, just add one URL. Prefer to\nrun it yourself? See [Local install](#local-install-npx) below.\n\n### Hosted (no install) — recommended\n\nPoint your AI client at:\n\n```\nhttps://mcp.amcharts.com/mcp\n```\n\n**Claude Code**\n\n```bash\nclaude mcp add --transport http amcharts5 https://mcp.amcharts.com/mcp\n```\n\n**Claude Desktop / claude.ai** — Settings → Connectors → **Add custom connector**, then paste `https://mcp.amcharts.com/mcp`.\n\n**Cursor** — `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"url\": \"https://mcp.amcharts.com/mcp\"\n    }\n  }\n}\n```\n\n**VS Code + GitHub Copilot** — `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"amcharts5\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.amcharts.com/mcp\"\n    }\n  }\n}\n```\n\n**Windsurf** — `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"serverUrl\": \"https://mcp.amcharts.com/mcp\"\n    }\n  }\n}\n```\n\n**ChatGPT** (Plus/Pro/Enterprise with connectors/developer mode enabled) — Settings → **Connectors** → **Add custom connector**, then paste `https://mcp.amcharts.com/mcp`.\n\n**Cline** (VS Code extension) — open the **MCP Servers** panel → **Remote Servers**, paste `https://mcp.amcharts.com/mcp`, or add to its MCP settings JSON:\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https://mcp.amcharts.com/mcp\"\n    }\n  }\n}\n```\n\n**Clients that only support local (stdio) servers** (e.g. Zed, Continue, Amazon Q Developer) — bridge to the hosted URL with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote). Use this as the server's run command in the client's config:\n\n```bash\nnpx mcp-remote https://mcp.amcharts.com/mcp\n```\n\nFor example, in a `command`/`args` style config:\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.amcharts.com/mcp\"]\n    }\n  }\n}\n```\n\nAny other MCP client that accepts a remote server URL works too — use the `/mcp`\nendpoint (Streamable HTTP) or `/sse` (legacy SSE). For URL-only clients that still\nexpect a command, use the `mcp-remote` bridge shown above.\n\n## Local install (npx)\n\nPrefer running it yourself? The server is also published to npm and runs over stdio.\n\n### Claude Code\n\nFor **all projects** (global, recommended):\n\n```bash\nclaude mcp add -s user amcharts5 -- npx -y @amcharts/amcharts5-mcp\n```\n\nFor **current project only**:\n\n```bash\nclaude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amcharts/amcharts5-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nCreate or edit `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` for global):\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amcharts/amcharts5-mcp\"]\n    }\n  }\n}\n```\n\n### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"amcharts5\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amcharts/amcharts5-mcp\"]\n    }\n  }\n}\n```\n\n### VS Code + GitHub Copilot\n\nCreate or edit `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"amcharts5\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amcharts/amcharts5-mcp\"]\n    }\n  }\n}\n```\n\n### Other MCP-compatible tools\n\nFor any other tool that supports MCP (Cline, Continue, Amazon Q, Zed, etc.), configure it to run:\n\n```bash\nnpx -y @amcharts/amcharts5-mcp\n```\n\n### Run locally (for development)\n\n```bash\ngit clone https://github.com/amcharts/amcharts5-mcp.git\ncd amcharts5-mcp\nnpm install\nnpm start\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_core_reference` | Get core amCharts 5 docs — setup, themes, colors, events, common pitfalls |\n| `get_chart_reference` | Get full reference for a chart type (e.g. \"pie\", \"sankey\", \"xy\") |\n| `list_chart_types` | List all available chart types and their keywords |\n| `search_docs` | Search the skill reference docs by keyword |\n| `search_all` | Search across **everything** — skill docs, full documentation, and code examples |\n| `get_doc` | Get a full documentation page (e.g. \"charts/xy-chart/axes\", \"concepts/events\") |\n| `get_section` | Get a specific section from a reference file by heading |\n| `get_quick_start` | Get a minimal working template for any chart type |\n| `list_examples` | Browse all 283 examples, optionally filtered by category |\n| `get_example` | Get the full code for a specific example |\n\n## Example Usage\n\nOnce connected, your AI assistant can:\n\n- **\"Build me a pie chart\"** → AI calls `get_quick_start(\"pie\")` and adapts the template\n- **\"How do I format date axis labels?\"** → AI calls `search_all(\"date axis label format\")`\n- **\"Show me the Sankey diagram example\"** → AI calls `get_example(\"examples/flow/sankey-diagram\")`\n- **\"What settings does XYChart support?\"** → AI calls `get_doc(\"reference/xychart\")`\n- **\"How do I integrate with React?\"** → AI calls `get_doc(\"getting-started/integrations/react\")`\n- **\"What chart types are available?\"** → AI calls `list_chart_types()`\n\n## Content\n\nThe server includes **1,500+ documents**:\n\n- **140+ 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)\n- **280+ 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\n- **1,000+ class API references** — every class in the amCharts 5 library with its settings, properties, methods, events, and inheritance chain\n- **Curated skill reference** — quick-start templates and chart-specific guides from the [amCharts 5 AI Skill](https://github.com/amcharts/amcharts5-skill)\n\n## License\n\nMIT\n",
  "bytes": 6687,
  "sha": "fa72935f86b6fa1f191820509ace95e9b9d2a87ff146c6d15c02148e1382ef52",
  "repo_slug": "amcharts/amcharts5-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_amcharts_amcharts5_2f7b06f0/readme"
}