MCP Dashboards
Turn your data into interactive dashboards inside any AI client - MCP Apps powered
Install / Use
/learn @KyuRish/MCP DashboardsQuality Score
Category
Development & EngineeringSupported Platforms
README
MCP Dashboards
<!-- mcp-name: io.github.KyuRish/mcp-dashboards -->Your AI can talk about data. Now it can show it.
The problem
We use AI for everything - analysis, reports, strategy. But when it comes to actually seeing the story in your data, you're stuck copying numbers into a spreadsheet and building charts yourself. The conversation has the insight. The visualization is somewhere else.
The solution
MCP Dashboards renders interactive charts, dashboards, and KPI widgets directly inside your AI conversation. 31 tools covering 44+ chart subtypes (bar has stacked/drilldown, hero has 11 variants, etc.), 20 themes, live polling, PNG/PPT/A4 export - all from a single MCP server. No browser tabs, no copy-paste, no context switching.
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"dashboard": {
"command": "npx",
"args": ["-y", "mcp-dashboards", "--stdio"]
}
}
}
Claude Code / VS Code
claude mcp add dashboard -- npx -y mcp-dashboards --stdio
Remote (Streamable HTTP)
npx mcp-dashboards
# Server starts on http://localhost:3001/mcp
Supported clients
Works in any MCP Apps-compatible client: Claude Desktop, Claude Web, VS Code (GitHub Copilot), Goose, Postman, MCPJam. ChatGPT support is rolling out.
Just ask
No API to learn. Describe what you want in plain English:
- "Compare Q1 vs Q2 revenue by region as a bar chart"
- "Show my portfolio allocation as a donut chart with the boardroom theme"
- "Build a dashboard with monthly sales KPIs and a trend line"
- "Visualize website traffic by country on a world map"
- "Track Bitcoin price live, updating every 30 seconds"
- "Show the conversion funnel from signup to purchase"
- "Rank the team by performance using a radar chart"
The AI picks the right tool, formats your data, and renders the chart inline. Click any data point to ask follow-up questions.
Interactive charts, not images
Every chart is interactive HTML rendered directly in your conversation:
- Explore in-chat - hover tooltips, click-to-select (feeds back to the AI), drill-down with breadcrumbs, scroll-zoom up to 12x on maps and heatmaps
- Live polling - real-time charts that auto-update from any API on a timer
- Export anywhere - PPT (16:9 slides), A4 (paginated with smart page breaks), PNG, CSV
| Tool | Type | Best For |
|------|------|----------|
| render_pie_chart | Pie/Donut | Composition - "what makes up the whole?" |
| render_bar_chart | Bar | Comparison - vertical, horizontal, stacked, drill-down |
| render_line_chart | Line/Area | Trends - smooth curves, gradient fills, time series |
| render_scatter_chart | Scatter | Relationships - per-point labels, annotations, quadrants |
| render_candlestick_chart | Candlestick | Finance - OHLC data with volume bars |
| render_radar_chart | Radar | Multi-axis comparison - skills, scores, product attributes |
| render_treemap_chart | Treemap | Hierarchy - nested rectangles sized by value |
| render_sankey_chart | Sankey | Flow - money, users, or resources between stages |
| render_wordcloud_chart | Word Cloud | Frequency - sized words from text analysis |
| render_boxplot_chart | Boxplot/Violin | Distribution - quartiles, outliers, density shapes |
| render_live_chart | Live | Real-time - auto-polls any MCP tool on a timer |
| poll_http | Data proxy | Fetch JSON from any HTTP endpoint - secure presets or public URLs |
| render_bullet_chart | Bullet | KPI vs target - 2-8 zone bands with labels |
| render_lollipop_chart | Lollipop | Ranking - clean dots with optional target markers |
| render_dumbbell_chart | Dumbbell | Gaps - before/after with scale labels and zone bands |
| render_variance_chart | Variance | Budget - actual vs budget, color-coded over/under |
| render_funnel_chart | Funnel | Conversion - staged drop-off with percentages |
| render_slope_chart | Slope | Change - ranking shifts between two periods |
| render_waffle_chart | Waffle | Proportion - 10x10 grid showing composition |
| render_sparkline_chart | Sparkline | Compact trends - mini cards with change indicators |
| render_radial_cluster | Radial | Health check - multi-metric ring gauges with status |
| render_waterfall_chart | Waterfall | Cumulative - cascading bars showing impact |
| render_heatmap_chart | Heatmap | Intensity - 2D grid with color mapping |
| render_geo_chart | Geo/Map | Geography - color-coded countries by value (choropleth) |
| render_bubble_map | Bubble Map | Pin map - sized circles at lat/lng coordinates |
| render_timeline_chart | Timeline | Progress - milestone tracker with status indicators |
| render_hero_metric | Hero | KPI widgets - 11 variants (progress ring, gem, orb, NPS, etc.) |
| render_dashboard | Dashboard | Everything - KPI cards + multiple charts in responsive grid |
| render_table | Table | Data - sortable columns, striped rows, CSV export |
| render_from_json | Auto-detect | Any JSON data - picks the best chart automatically |
| render_from_url | URL fetch | Fetches JSON from a URL and auto-visualizes |
| Question | Best Chart | Also Works | |----------|-----------|------------| | "What makes up the whole?" | Pie/Waffle | Treemap, Stacked bar | | "How do values compare?" | Bar | Lollipop, Bullet, Radar | | "What's the trend over time?" | Line | Sparkline, Slope | | "Are we hitting targets?" | Bullet | Variance, Radial | | "Where's the gap?" | Dumbbell | Variance | | "How does X relate to Y?" | Scatter | Heatmap | | "What's the conversion rate?" | Funnel | Waterfall, Sankey | | "What changed between periods?" | Slope | Dumbbell | | "What's the financial picture?" | Candlestick | Line | | "Show me the KPI" | Hero metric | Dashboard | | "What's the distribution?" | Boxplot | Violin (same tool) | | "Where does money/traffic flow?" | Sankey | Treemap | | "How do options score across axes?" | Radar | Heatmap | | "What are the top keywords?" | Word Cloud | Bar, Treemap | | "Where are users/sales/revenue?" | Geo map | Bubble map, Heatmap | | "Monitor this in real-time" | Live chart | - |
</details>Themes
20 built-in themes. Pass theme to any tool.
| Family | Themes |
|--------|--------|
| Classic | boardroom, corporate, sales-floor, golden-treasury, clinical, startup, ops-control, tokyo-midnight, zen-garden, consultant |
| Black/AI | black-tron (cyan neon), black-elegance (warm gold), black-matrix (green hacker) |
| Forest | forest-amber (autumn), forest-earth (terracotta) |
| Sky | sky-light (airy blue), sky-ocean (deep navy), sky-twilight (sunset) |
| Gray/ML | gray-hf (warm yellow accent), gray-copilot (teal on dark) |
Mix-and-match with palette, typography (8 options: system, mono, professional, editorial, bold, techno, cyberpunk, luxury), and effects (5 presets: none, subtle, shimmer, neon, energetic).
Live Polling
Real-time charts that auto-update from any API. The live chart polls data via poll_http, which supports two modes:
Secure presets (authenticated APIs)
Configure presets via env vars. Credentials stay server-side and never appear in the conversation.
{
"mcpServers": {
"dashboard": {
"command": "npx",
"args": ["-y", "mcp-dashboards", "--stdio"],
"env": {
"POLL_PRESET_T212_CASH_URL": "https://live.trading212.com/api/v0/equity/account/cash",
"POLL_PRESET_T212_CASH_HEADERS": "{\"Authorization\": \"Bearer YOUR_API_KEY\"}"
}
}
}
}
Then ask: "Monitor my portfolio total and P/L live" - the AI uses render_live_chart with pollArgs: { preset: "t212_cash" }.
Naming: POLL_PRESET_<NAME>_URL and POLL_PRESET_<NAME>_HEADERS (JSON object).
Public URLs (no auth needed)
For public APIs, use the URL directly:
"Show me Bitcoin price updating every 30 seconds" - uses pollArgs: { url: "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd" }.
How It Works
Built on MCP Apps. You ask the AI to visualize data, it calls the right tool, and the chart renders inline in your conversation. Self-contained - zero CDN, zero external requests.
Requirements: Node.js 18+ and an MCP Apps-compatible client.
<details> <summary><strong>Contributing</strong></summary>git clone https://github.com/KyuRish/mcp-dashboards.git
cd mcp-dashboards
npm install
npm run build
npm run serve # http://localhost:3001
npm r
