The Vega-Lite MCP Server provides AI assistants with comprehensive access to Vega-Lite documentation, examples, validation tools, and schema information.
Search documentation: Search through Vega-Lite documentation for information about charts, encodings, marks, and more
Retrieve examples: Get Vega-Lite example specifications by category or type (bar, line, scatter, area, histogram, heatmap, interactive, etc.) with optional search terms
Validate specifications: Validate Vega-Lite JSON specifications to check for errors and ensure correctness
Access schema information: Get detailed information about Vega-Lite schema properties and overall structure (mark, encoding, data, transform, etc.)
Provides access to Vega-Lite documentation, examples, and validation tools, enabling AI assistants to search documentation, retrieve visualization examples by category, validate specifications, and access schema information for creating data visualizations.
Vega-Lite MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to Vega-Lite documentation, examples, and validation tools.
What it does
This server enables AI assistants like Claude to:
š Search Vega-Lite documentation
š Get visualization examples by category
ā Validate Vega-Lite specifications
š Access schema information
Quick Start
1. Install
2. Configure
Claude Code (VS Code) - Recommended ā
Then completely close and reopen VS Code (important - don't just reload).
Claude Desktop
Edit your config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Linux:
~/.config/Claude/claude_desktop_config.json
Add:
Restart Claude Desktop.
3. Verify
Claude Code: Type /mcp
- you should see "vegalite" listed
Claude Desktop: Look for the šØ tools indicator
4. Try it
Available Tools
Tool | What it does | Example |
| Search documentation | "How do filter transforms work?" |
| Get examples by category | "Show me a line chart example" |
| Validate JSON specs | "Validate this Vega-Lite spec: {...}" |
| Get schema details | "What encoding channels are available?" |
Troubleshooting
Server not showing up?
Check the path is absolute and correct
Test manually:
node /path/to/dist/index.js
(should say "running on stdio")For Claude Code: Completely close and reopen VS Code (not just reload)
Verify with
/mcp
(Claude Code) or look for tools indicator (Claude Desktop)
Tools not working?
Remove the server:
Development
Project Structure
Manual Configuration
Claude Code (Manual)
Press
Ctrl+Shift+P
(orCmd+Shift+P
on Mac)Type:
Claude Code: Edit MCP Settings
Add:
Save and completely close/reopen VS Code
Other MCP Clients
Add the same configuration to your client's MCP settings file. Check your client's documentation for the config file location.
Contributing
Contributions welcome! Please submit a Pull Request.
See CONTRIBUTING.md for development guidelines.
Future Features
For information about deploying as a remote server, see docs/DEPLOYMENT.md.
License
MIT License - See LICENSE
Links
Issues: https://github.com/inteligencianegociosmmx/vegaLite_mcp_server/issues
Vega-Lite Docs: https://vega.github.io/vega-lite/
MCP Docs: https://modelcontextprotocol.io
Built with
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Provides AI assistants with access to Vega-Lite documentation, visualization examples, and specification validation tools. Enables searching docs, retrieving examples by category, validating JSON specs, and accessing schema information for creating data visualizations.