Set up the MCP server
kubb mcp, the Kubb Model Context Protocol server, lets your editor or agent validate a spec, scaffold a kubb.config.ts, and run Kubb from the chat. Tools lists each tool.
@kubb/plugin-mcp instead.Add the server to your client
Each client starts the server with npx kubb mcp over stdio.
Run this from your project root, next to your kubb.config.ts:
claude mcp add kubb -- npx kubb mcpAdd --scope project to write the entry to .mcp.json for your team. The Kubb Claude Code plugin registers the same server.
Add the entry to claude_desktop_config.json (on macOS in ~/Library/Application Support/Claude/, on Windows in %APPDATA%\Claude\) or to the server list in Cursor's Settings → MCP:
{
"mcpServers": {
"kubb": {
"command": "npx",
"args": ["kubb", "mcp"]
}
}
}VS Code (GitHub Copilot) uses a servers key. Add the entry to .vscode/mcp.json, or, for every workspace, run MCP: Open User Configuration from the Command Palette:
{
"servers": {
"kubb": {
"command": "npx",
"args": ["kubb", "mcp"]
}
}
}Start it in your project
The server looks for your config in the folder the client starts it in, then in each parent folder. Claude Code starts it in the folder you run claude from.
No config file found
The client started the server outside your project. Clients such as Claude Code ignore a cwd key, so change into the project in the command (macOS and Linux):
{
"mcpServers": {
"kubb": {
"command": "sh",
"args": ["-c", "cd '/path/to/your/project' && npx kubb mcp"]
}
}
}Working directory lists what the server reads and writes.
