# amcharts5 [Health: Active]

**Category:** 📊 Data Visualization  
**Repository:** https://github.com/amcharts/amcharts5-mcp  
**GitHub Stars:** 9  
**npm Downloads (last month):** 4892  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/amcharts5

## Description
On-demand access to amCharts 5 docs, code examples, and API reference

## Tools
Capabilities this server exposes over MCP:

- **list_chart_types** — List all amCharts 5 chart types with their categories and reference file names
- **get_chart_reference** — Get the reference documentation for a specific amCharts 5 chart type. A reference longer than 12,000 characters comes as an overview: its first parts in full and a list of the others, each of which get_section returns. With `full: true` it is the whole file. The chart type keywords are listed by list_chart_types.
- **get_core_reference** — Get the core amCharts 5 reference (SKILL.md) — covers setup, colors, themes, legends, tooltips, events, data, adapters, disposal, and common pitfalls. It is the base for every chart type; the chart-specific references build on it. It comes as an overview: its first sections, up to 12,000 characters, and a list of the others, each of which get_section("SKILL", heading) returns. With `full: true` it is the whole file.
- **search_docs** — Search the curated amCharts 5 skill docs (SKILL.md + chart references) for a keyword or topic, returning matching sections ranked by relevance. By default it searches only the skill layer. With scope 'all' it also searches the extended docs, the per-class API reference and the code examples. Per-setting defaults (e.g. tooltip background cornerRadius, axis tick `visible` default, cursor line strokeDasharray) are in the extended docs and the API reference, which search_all, get_api_reference and get_doc also return.
- **get_section** — Get the full text of one section of a doc by heading, for example a section that a search_docs or search_all result shows truncated. `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').
- **get_quick_start** — Get a quick-start template for a specific chart type — a minimal working example ready to customize.
- **search_all** — Search across all amCharts 5 content: skill references, full documentation, and code examples. For broad searches across everything.
- **get_doc** — Get a full documentation page — an extended doc by path, or a skill file by 'skill/<name>'. Paths are the source labels that search_docs and search_all print.
- **get_api_reference** — 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. It is generated from the library's typings, so it has the exact setting names and default values (e.g. tooltip background cornerRadius, axis tick `visible` default). Takes a class name in any casing, e.g. 'XYCursor', 'Tooltip', 'PieSeries', 'AxisRendererX'.
- **list_examples** — List all available amCharts 5 code examples, optionally filtered by category.
- **get_example** — Get the full code for a specific amCharts 5 example/demo, by its path or its amcharts.com demo address. Paths are listed by list_examples and printed in search results.
- **list_geodata** — List amCharts 5 geodata (map) files with each one's CDN path, script global name and ES module import: world maps, continents, every country map, regional packs (US states and counties, Canada, Mexico) and the US congressional-district packs, which are versioned per Congress (congressional120 = 120th Congress is the newest). Also the data/countries2 and lang/* helper files. It gives the exact file path and global name that map code needs.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

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

## Documentation

## What amcharts5 does

amcharts5 gives MCP-compatible AI clients on-demand access to amCharts 5 reference material. The content covers the core library, individual chart types, extended documentation, class-level API information, runnable examples, and map geodata. The collection includes more than 160 documentation pages, over 690 examples, and more than 1,300 API reference pages.

The server is suited to implementation and troubleshooting tasks such as choosing a chart type, finding an exact setting default, adapting a working example, or locating the import and CDN details for a map file. It serves reference content rather than creating or rendering charts itself.

## How it works

Requests are made through MCP tools. Broad questions can use `search_docs` or `search_all`, while targeted requests can retrieve a core reference, chart reference, documentation page, API class, example, or section. Large reference files are returned as an overview with section names; callers can request the remaining content with `get_section`, or request the complete file with `full: true` where supported.

The hosted endpoint uses Streamable HTTP at `https://mcp.amcharts.com/mcp`, with a legacy SSE endpoint at `/sse`. A local npm package runs over stdio. The server can also be reached from clients that only accept local servers by using the `mcp-remote` bridge.

## Setup and configuration

For the hosted option, configure an MCP client with the server URL `https://mcp.amcharts.com/mcp`. Claude Code, Claude Desktop, Cursor, Windsurf, VS Code with GitHub Copilot, and Cline have documented connection formats. Other clients that accept remote MCP URLs can use the same endpoint; clients restricted to stdio can run:

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

For local execution, use the npm package through `npx`:

```bash
npx -y @amcharts/amcharts5-mcp
```

A source checkout can be installed with `npm install` and started with `npm start`.

## Tools and capabilities

- `list_chart_types` returns chart categories and reference-file keywords.
- `get_chart_reference` and `get_core_reference` provide chart-specific and foundational guidance, including setup, themes, data, events, adapters, disposal, and common pitfalls.
- `search_docs`, `search_all`, `get_doc`, and `get_section` locate and retrieve documentation at different levels of breadth.
- `get_quick_start` returns a minimal template for a selected chart type.
- `list_examples` and `get_example` browse and retrieve complete demo code.
- `get_api_reference` returns a class page, settings, defaults, and optional private or read-only settings.
- `list_geodata` identifies map files with CDN paths, script globals, and ES module imports.

## Limitations and notes

The most focused search is `search_docs`, which searches the skill references by default. Its `all` scope adds extended documentation, API references, and examples; `search_all` searches those broader sources directly. Long references may require follow-up calls to `get_section`. Chart-specific references build on the core reference, so both may be relevant when an implementation depends on general amCharts 5 behavior.

_Full upstream README: https://allmcps.com/mcp/amcharts5/readme_

