MCP Dashboards

<!-- mcp-name: io.github.KyuRish/mcp-dashboards -->

Your AI can talk about data. Now it can show it.

<p align="center"> <img src="assets/demo.gif" width="400" alt="MCP Dashboards demo" /> <br> <a href="assets/dashboard-example.png"><img src="assets/dashboard-example.png" width="115" height="220" alt="Infrastructure Command Center dashboard" /></a>  <a href="assets/chart-catalog.png"><img src="assets/chart-catalog.png" width="115" height="220" alt="Chart Catalog - 45+ chart types" /></a>  <a href="assets/theme-catalog.png"><img src="assets/theme-catalog.png" width="115" height="220" alt="Theme Catalog - 20 themes" /></a> <br>_{Click any thumbnail to see full size} </p>

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. 45+ chart types, 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.

What makes this different

Other MCP chart tools generate static images. MCP Dashboards renders interactive HTML inside your conversation.

Explore your data in-chat

• Hover tooltips on every data point - no guessing values
• Click to select any bar, slice, or point - selections feed back to the AI for follow-up questions
• Drill-down into bar charts with breadcrumb navigation
• Zoom & pan on geo maps, treemaps, and heatmaps - scroll-wheel zoom up to 12x with hi-res re-rendering
• Live polling - real-time charts that auto-update from any API (stock prices, server metrics, crypto)
• KPI sparklines - inline trend mini-charts in dashboard metric cards

Meeting in 5 minutes? Export and go

• PPT slides - one-click download as a 16:9 title slide or background-ready image
• A4 documents - paginated multi-page export with intelligent page breaks that never cut through a chart
• PNG - per-chart screenshots with title and theme baked in
• CSV - raw data export from any table

Ask the AI to build your dashboard. Hit the export dropdown - grab a 16:9 title slide, a background image, or a paginated A4 document. One click, presentation-ready.

20 themes, 900+ combinations

Boardroom gold, neon cyberpunk, forest earth, clinical white. Mix palettes, typography (8 options), and effects (shimmer, neon, glow, glass, lift). Animated gradient titles export correctly to PNG.

45+ chart types across 20 themes = 900+ visual combinations. Every one of them interactive.

<details> <summary><strong>All 31 Tools</strong></summary>

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

</details>

<details> <summary><strong>Which chart should I use?</strong></summary>

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 run dev     # watch mode

</details>

Support

If MCP Dashboards is useful to you:

License

FSL-1.1-MIT - Free to use for any purpose except building a competing commercial product. Each version converts to MIT two years after release. For commercial licensing, contact contact@kyuish.com.