# openapi-mcp-generator

> Free, MIT-licensed CLI and library that turns an OpenAPI 3.x specification into a Model Context Protocol (MCP) server. Transports: stdio, web (SSE), streamable-http and cloudflare-worker. MCP Cloud, a hosted option, is in private beta and not live.

Quick start: `npx openapi-mcp-generator --input ./openapi.json --output ./my-mcp --transport=cloudflare-worker`

- Source: https://github.com/harsha-iiiv/openapi-mcp-generator
- npm: https://www.npmjs.com/package/openapi-mcp-generator
- Maintainer: Harsha Vardhan, Long Beach, California

## Docs

- [Introduction](https://pidata.tech/docs/introduction.md): openapi-mcp-generator turns OpenAPI 3.x specifications into MCP servers. Learn what it generates and which transport to choose.
- [Quickstart](https://pidata.tech/docs/quickstart.md): Generate your first MCP server from an OpenAPI spec in a few minutes, run it locally and connect it to an MCP client.
- [CLI options](https://pidata.tech/docs/cli-options.md): Every openapi-mcp-generator command-line flag, with aliases, defaults and examples.
- [Transports](https://pidata.tech/docs/transports.md): Compare the stdio, web (SSE), streamable-http and cloudflare-worker transports and pick the right one for your MCP server.
- [Authentication](https://pidata.tech/docs/authentication.md): Configure API key, bearer, basic and OAuth2 client-credentials auth for generated MCP servers using environment variables and wrangler secrets.
- [Programmatic API](https://pidata.tech/docs/programmatic-api.md): Use getToolsFromOpenApi to extract MCP tool definitions from an OpenAPI spec inside your own Node.js code.
- [Deploy to Cloudflare Workers](https://pidata.tech/docs/deploy-cloudflare-workers.md): Host an MCP server on Cloudflare Workers. Generate a Worker from OpenAPI, set secrets with wrangler and deploy to your own account.
- [Connect clients](https://pidata.tech/docs/connect-clients.md): Connect a generated MCP server to Claude Code, Cursor, VS Code and Claude.ai, over stdio locally or Streamable HTTP remotely.
- [Large APIs](https://pidata.tech/docs/large-apis.md): Choose which OpenAPI operations become MCP tools with x-mcp and filters, and keep tool names within the 64-character limit.
- [Security model](https://pidata.tech/docs/security-model.md): What openapi-mcp-generator protects against, what it leaves to you, and how to report a vulnerability.
- [FAQ](https://pidata.tech/docs/faq.md): Answers to common questions about openapi-mcp-generator, Swagger support, hosting, credentials and MCP Cloud.
- [Changelog](https://pidata.tech/docs/changelog.md): Release history for openapi-mcp-generator, summarized from the repository CHANGELOG.

## Pages

- [MCP Cloud (private beta): host an MCP server on Cloudflare](https://pidata.tech/cloud): Join the MCP Cloud private beta: paste an OpenAPI spec and get a hosted, isolated MCP server on Cloudflare Workers. Not live yet. Join the waitlist.
- [Pricing: free open source and MCP Cloud beta plans](https://pidata.tech/pricing): openapi-mcp-generator is free forever. MCP Cloud beta pricing: Free, Pro and Team plans with hard limits by default and no surprise overages.
- [Security and trust for MCP Cloud](https://pidata.tech/security): How MCP Cloud is designed to keep your API and credentials safe: isolated Workers, metadata-only logs, encrypted secrets and allow-listed hosts. Planned for beta.
- [Stainless MCP alternative: migrate your hosted MCP server](https://pidata.tech/guides/stainless-mcp-migration): Stainless is winding down hosted products. Step-by-step guide to regenerating your MCP server from OpenAPI with openapi-mcp-generator and deploying to Cloudflare.
- [Terms of Service (draft)](https://pidata.tech/terms): Draft Terms of Service for MCP Cloud. Not yet in effect.
- [Privacy Policy (draft)](https://pidata.tech/privacy): Draft Privacy Policy for pidata.tech and MCP Cloud. Not yet in effect.
- [Acceptable Use Policy (draft)](https://pidata.tech/acceptable-use): Draft Acceptable Use Policy for MCP Cloud. Not yet in effect.