| name | api-to-mcp |
| description | Generate production-ready TypeScript MCP servers from OpenAPI 3.x JSON specs or URLs. Use when the user asks to convert an API/OpenAPI/Swagger document into an MCP server, install API tools for agents, or run api-to-mcp from Codex. |
api-to-mcp
Use this skill to generate a TypeScript MCP server from an OpenAPI 3.x JSON spec.
Decide the mode
- Local spec: use
generate.
- Remote spec or API base URL: use
create.
- Swagger 2.0: tell the user to convert it to OpenAPI 3.x first.
- Relative
servers.url in a local spec: require --base-url.
Commands
From this repository:
npm install
npm run build
node dist/cli.js generate ./openapi.json --out ./my-mcp-server
node dist/cli.js create --url https://api.example.com/openapi.json --out ./my-mcp-server
From GitHub without a local checkout:
npm install -g @taozhang123/api-to-mcp
api-to-mcp generate ./openapi.json --out ./my-mcp-server
api-to-mcp create --url https://api.example.com/openapi.json --out ./my-mcp-server
Auth examples
Bearer token:
node dist/cli.js create --url https://api.example.com/openapi.json --key "$API_TOKEN" --out ./my-mcp-server
API key header:
node dist/cli.js create --url https://api.example.com/openapi.json --auth api-key --key "$API_KEY" --key-header x-api-key --out ./my-mcp-server
After generation
Run:
cd ./my-mcp-server
npm install
npm run build
npm start
Do not print secrets back to the user.
