MCP Server

A hosted Model Context Protocol server that exposes Volt UI components, usage examples, theme info, and CLI commands as tools any compatible agent can call.

What is MCP?

The Model Context Protocol is an open standard that lets LLMs talk to external tools, resources, and prompts. The Volt UI MCP server runs at https://volt-ui.pages.dev/api/mcp and exposes a spec-compliant Streamable HTTP endpoint. Agents can list components, read detailed metadata, fetch usage examples, and even retrieve reusable prompts.

Quick Setup

Run the interactive installer from your project directory:

npx volt-ui-mcp

It asks which agent(s) to set up, then writes the right config files automatically. You can also pass the agent directly:

# one agent

npx volt-ui-mcp claude

npx volt-ui-mcp cursor

# multiple

npx volt-ui-mcp cursor copilot

Supported Agents

Claude

MCP native

Claude Desktop and Claude Code — full tool access via the hosted MCP server.

npx volt-ui-mcp claude

Writes .claude/mcp.json and patches the Claude Desktop global config if found.

Cursor

MCP native

Full MCP support plus a .cursorrules file with component context for inline suggestions.

npx volt-ui-mcp cursor

Writes .cursor/mcp.json and .cursorrules .

Windsurf

MCP native

Codeium's Windsurf editor with native MCP support.

npx volt-ui-mcp windsurf

Writes .codeium/windsurf/mcp_config.json .

GitHub Copilot

instructions

Copilot doesn't support MCP HTTP yet — the installer writes a Copilot instructions file and VS Code snippets instead.

npx volt-ui-mcp copilot

Writes .github/copilot-instructions.md and .vscode/volt-snippets.code-snippets .

Manual Configuration

For MCP-native agents, add this entry to your config file: