@amcharts/amcharts5-mcp 1.0.0

package/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "amcharts5-skill"]
+	path = amcharts5-skill
+	url = https://github.com/amcharts/amcharts5-skill.git

package/README.md

@@ -0,0 +1,82 @@
+# amCharts 5 MCP Server
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants on-demand access to amCharts 5 documentation, examples, and API reference.
+
+Works with **Claude Code**, **Claude Desktop**, **Cursor**, 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 search for "tooltip formatting", or a quick-start template. This means better answers with less context waste.
+
+## Quick Start
+
+### Claude Code
+
+```bash
+claude mcp add amcharts5 -- npx -y @amcharts/amcharts5-mcp
+```
+
+### Claude Desktop / Cursor
+
+Add to your MCP config (`claude_desktop_config.json` or Cursor settings):
+
+```json
+{
+  "mcpServers": {
+    "amcharts5": {
+      "command": "npx",
+      "args": ["-y", "@amcharts/amcharts5-mcp"]
+    }
+  }
+}
+```
+
+### Run locally (for development)
+
+```bash
+git clone https://github.com/amcharts/amcharts5-mcp.git
+cd amcharts5-mcp
+npm install
+npm start
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_chart_types` | List all available chart types and their keywords |
+| `get_chart_reference` | Get full reference docs for a chart type (e.g. "pie", "sankey", "xy") |
+| `get_core_reference` | Get core amCharts 5 docs — setup, themes, colors, events, common pitfalls |
+| `search_docs` | Search across all docs by keyword or topic |
+| `get_section` | Get a specific section by heading name from any reference file |
+| `get_quick_start` | Get a minimal working example for a chart type (HTML or ESM format) |
+
+## 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 axis labels?"** → AI calls `search_docs("axis label format")`
+- **"Show me the full radar chart API"** → AI calls `get_chart_reference("radar")`
+- **"What chart types are available?"** → AI calls `list_chart_types()`
+
+## Content
+
+The server indexes the [amCharts 5 AI Skill](https://github.com/amcharts/amcharts5-skill) documentation covering:
+
+- **Core**: setup, themes, colors, legends, tooltips, events, data, adapters, disposal
+- **XY charts**: line, area, bar, column, candlestick, scatter, stacked
+- **Pie & Sliced**: pie, donut, funnel, pyramid
+- **Maps**: world, country, choropleth, bubble map, point map
+- **Hierarchy**: treemap, sunburst, force-directed, pack, partition
+- **Flow**: Sankey, chord, arc diagram
+- **Radar**: radar, spider, polar, gauge
+- **Stock**: financial/trading charts
+- **Timeline**: serpentine, spiral, curve
+- **Gantt**: project timelines
+- **Word Cloud & Venn**
+- **UI Elements**: buttons, sliders, steppers, color pickers
+
+## License
+
+MIT

package/amcharts5-skill/README.md

@@ -0,0 +1,50 @@
+# amcharts5-skill
+
+An AI skill for building [amCharts 5](https://www.amcharts.com/docs/v5/) charts and data visualizations. Works with Claude, Cursor, GitHub Copilot, and any AI assistant that supports custom context or skill files.
+
+Supports XY (line, bar, area, scatter), pie/donut, maps, hierarchy (treemap, sunburst), flow (Sankey, chord), radar, stock/financial, Gantt, word cloud, Venn, and timeline charts.
+
+AI docs: https://www.amcharts.com/docs/v5/ai/
+
+## Installation
+
+### Claude Code
+
+Add the skill to your project's `.claude/skills/` directory:
+
+```sh
+git clone https://github.com/amcharts/amcharts5-skill .claude/skills/amcharts5-skill
+```
+
+### Claude.ai (web)
+
+1. Download this repo as a ZIP
+2. Go to **Claude.ai → Settings → Skills**
+3. Click **Upload skill** and select the ZIP
+4. Toggle the skill on
+
+### Cursor / Windsurf / other editors
+
+Copy or symlink the skill files into your project, then add them to your AI context. For example, in Cursor add the files to `.cursorrules` or reference them via `@file` in chat.
+
+### Any AI assistant
+
+The skill is plain Markdown. You can paste the contents of `SKILL.md` and the relevant `references/*.md` files directly into any AI chat as context before asking your question.
+
+## Usage
+
+Once installed, just ask your AI assistant to build a chart:
+
+```
+Create a bar chart showing monthly sales data using amCharts 5
+```
+
+```
+Build a world map choropleth with country GDP data
+```
+
+```
+Add a legend and animated transitions to my amCharts pie chart
+```
+
+The skill automatically loads the right reference documentation for the chart type you're building.