@kubb/plugin-mcp

@kubb/plugin-mcp turns your OpenAPI spec into a Model Context Protocol server. Each operation becomes one MCP tool. AI assistants like Claude Desktop and Claude Code call those tools to reach your API. The plugin generates the tool handlers plus a server.ts and .mcp.json, and validates each call with the schemas from @kubb/plugin-zod.

Each handler calls a registered client plugin, so you must add @kubb/plugin-axios or @kubb/plugin-fetch alongside @kubb/plugin-ts and @kubb/plugin-zod. Without a client plugin, the build stops with a setup error.

This plugin generates an MCP server from your spec. It is not the same as the built-in kubb mcp server that exposes the Kubb CLI itself, which is documented under AI / MCP.

The Connect Claude to a remote MCP server guide explains how to register the generated server with an assistant.

Installation

bun

bun add -d @kubb/plugin-mcp@beta

pnpm

pnpm add -D @kubb/plugin-mcp@beta

npm

npm install --save-dev @kubb/plugin-mcp@beta

yarn

yarn add -D @kubb/plugin-mcp@beta

Dependencies

This plugin needs three other plugins. @kubb/plugin-ts and @kubb/plugin-zod are declared dependencies, so Kubb runs them before plugin-mcp and the handlers can import the generated types and Zod schemas. The client plugin is resolved separately at setup.

• @kubb/plugin-ts for the request and response types.
• @kubb/plugin-zod for the schemas that validate each tool call.
• @kubb/plugin-axios or @kubb/plugin-fetch for the HTTP client the handlers call.

A client plugin is required. The handlers call its generated functions, so the build stops with a setup error when no client plugin is registered. Register one of them and set client only when both are present.

Example

kubb.config.ts

import {  } from 'kubb'
import {  } from '@kubb/plugin-ts'
import {  } from '@kubb/plugin-axios'
import {  } from '@kubb/plugin-zod'
import {  } from '@kubb/plugin-mcp'

export default ({
  : { : './petStore.yaml' },
  : { : './src/gen' },
  : [
    (),
    ({ : 'https://petstore.swagger.io/v2' }),
    (),
    ({
      : { : 'mcp', : { : 'named' } },
      : {
        : 'tag',
        : ({  }) => `${}Handlers`,
      },
    }),
  ],
})

See also

• Connect Claude to a remote MCP server
• Changelog