Kubb MCP Server: Setup for Claude Code, Cursor and Other Apps
Lets Claude, Cursor and other assistants run Kubb to turn an OpenAPI spec into TypeScript types, API clients and validators.
Kubb is a code generator that turns an API spec such as OpenAPI into typed code. This server lets your assistant check a spec, create a starter config and run the build for you. It runs on your computer inside your project folder, so it must start in the folder that holds your Kubb config. Kubb makes it, and it ships in the Kubb repository.
Good for
- TypeScript developers who generate API clients from OpenAPI specs
- Teams that want an assistant to validate a spec before generating code
- Developers new to Kubb who want a starter config written for them
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Kubb MCP
Claude Code
- 1
Copy this prompt.
Add the Kubb MCP server to Claude Code. Run this command: claude mcp add kubb -- npx @kubb/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, A Kubb config in the project folder.
The server reads kubb.config.* from the folder it starts in. Claude Code starts it where you run claude, so add it from your project root. Use the second method when your app starts the server in another folder, and replace the example path with your project folder. It works on macOS and Linux. The README also offers kubb mcp from the kubb package, which gives the same server.
Built from the package data we hold. Not yet tested by us.
Tools
Generates TypeScript code from your API spec using your Kubb config
Runs a full Kubb build from your kubb.config file and writes the generated types, clients or validators to the output folder. A failed build returns its error messages instead. You can override the spec and output folder for one run.
Try: “Run Kubb with the petstore spec and write the output to src/generated.”
Runs code ·
generateChecks that an OpenAPI spec is valid
Validates an OpenAPI or Swagger spec from a file path or a web address and reports any problems.
Try: “Is specs/petstore.yaml a valid OpenAPI spec?”
Network ·
validateCreates a starter Kubb config file in your project
Writes a kubb.config.ts without asking questions. It installs no packages and fails if a config already exists.
Try: “Set up Kubb here with the zod and TypeScript plugins.”
Write ·
init
Read from the source code
Permissions
medium risk · 3 things to watch
Medium risk
The generate tool runs your Kubb config, which is code in your project, and writes the generated files to the output folder. Review the config and the output folder before you let the assistant run it.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Generate runs your config file and writes files
The config is a TypeScript file in your project and the build writes to the output folder. The tool can override that folder, so check where the output goes. github.com
It works only inside the folder it starts in
The server rejects a config path outside its working directory. Start it from your project root, or the tools will not find your config. github.com
Validate can fetch a spec from a web address
Given a URL, the tool downloads the spec. Use it on specs you trust. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. Validate only reads, while generate and init write files. |
|---|---|
| Talks to | Any web address you ask it to validate a spec from |
| Sign-in and keys | No account or key is needed. |
Questions
Do I need a Kubb project first?
Generating needs a kubb config file. The init tool can write a starter one, and validate works without any config.
Why does it say it cannot find my config?
The server looks in the folder it was started in. Claude Code starts it where you run claude, so register it from the project root. For apps that start it elsewhere, the README shows a version that changes into your project folder first.
Does it need an API key?
No. It runs locally and needs no account or key.
Can it overwrite my files?
Generate writes to the output folder in your config, or to a folder the assistant passes in. Init refuses to replace an existing kubb config. Keep your project in version control so you can review changes.
Which apps does it work with?
The README names Claude Desktop and Claude Code and says other MCP apps can use the same config entry. Use the install box above.
Is it official?
Yes. It is the Kubb project's own MCP server, published as the @kubb/mcp package from the Kubb repository.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@kubb/mcp- Registry
- npm
- Transport
- stdio
- Auth
- None
- Version
- 5.15.3
- License
- MIT
- Last commit
- Oct 29, 2026
- Open issues
- 5
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com