@kubb/mcp weekly downloads statistics

[![npm version][npm-version-src]][npm-version-href] [![npm downloads][npm-downloads-src]][npm-downloads-href] [![Stars][stars-src]][stars-href] [![License][license-src]][license-href] [![Node][node-src]][node-href]

Documentation · Report Bug · Request Feature

@kubb/mcp

Model Context Protocol server for Kubb

@kubb/mcp is the MCP server for Kubb. It exposes Kubb code generation as tools over the Model Context Protocol, so AI assistants such as Claude and Cursor can validate a spec and generate TypeScript types and API clients from the chat.

The server has three tools. generate runs a full Kubb build from a kubb.config.ts and returns its build events when the build succeeds. A failed build returns its diagnostics instead. validate checks an OpenAPI spec, and init scaffolds a kubb.config.ts.

Installation

Install as a dev dependency:

[!IMPORTANT] The kubb mcp command comes from @kubb/cli, which the kubb package includes. Install kubb to use it.

Usage

Start the MCP server

Start the server using the Kubb CLI:

Or run it directly as a standalone package:

Both commands start the same server over stdio.

Configure an MCP client

Add one of these entries to your MCP client's config, such as claude_desktop_config.json for Claude Desktop.

Using kubb mcp:

Using the standalone package:

The server looks for kubb.config.* in the directory the client starts it in, and rejects a config path outside that directory. Claude Code starts it in the folder you run claude from, so register it from the project root:

Clients such as Claude Code ignore a cwd key in this config. When a client starts the server in another directory, change into the project first (macOS and Linux):

Available tools

generate

Runs a Kubb build from your config. A successful build returns the build events, and a failed build returns its diagnostics.

Parameters:

• config (string, optional): Path to a config file inside the working directory. Defaults to kubb.config.ts (or .mts, .cts, .js, .mjs, .cjs) in the working directory • input (string, optional): Path to OpenAPI/Swagger spec file (overrides config file setting) • output (string, optional): Output directory path (overrides config file setting) • logLevel (enum, optional): One of 'silent', 'info', 'verbose' (default: 'info'), passed to a config that exports a function

Examples:

Using default config file:

Overriding input and output:

With verbose logging:

validate

Validates an OpenAPI/Swagger specification from a path or URL.

Parameters:

• input (string, required): Path or URL to the OpenAPI/Swagger specification

init

Writes a kubb.config.ts in the working directory without prompts. It does not install packages, and it fails when kubb.config.ts already exists.

Parameters:

• input (string, optional): Path to the OpenAPI spec (default: ./openapi.yaml) • output (string, optional): Output directory (default: ./src/gen) • plugins (string, optional): Comma-separated list of plugins, such as plugin-ts,plugin-zod

Configuration

The generate tool looks for kubb.config.ts in the working directory by default. Pass config to use another config file in that directory.

Example kubb.config.ts:

Supporting Kubb

Kubb is an open source project, and its development is funded entirely by sponsors. If you would like to become a sponsor, please consider:

• Become a Sponsor on GitHub • See sponsorship tiers and our sponsors

License

MIT

Description from the npm listing.