Generates an MCP server from an OpenAPI or Swagger specification using the mcp-use TypeScript SDK.
npx skills add https://github.com/mcp-use/mcp-use --skill openapi-to-mcp
Please help me install this Agent Skill. Skill: openapi-to-mcp Source: https://github.com/mcp-use/mcp-use/tree/main/skills/openapi-to-mcp Command: npx skills add https://github.com/mcp-use/mcp-use --skill openapi-to-mcp
Turning an existing REST API into something an LLM can call requires manually writing tool definitions, schemas, and auth wiring for every endpoint. This Skill automates that entire conversion: it ingests an OpenAPI 3.x or Swagger 2.0 document and produces a working, deployable MCP server where each API operation becomes a typed MCP tool.
Ask the agent to turn your OpenAPI spec file into an MCP server, for example: build an MCP server from the attached openapi.yaml and deploy it.
High-intent search queries and answers about installing and using this skill.
Provide the spec as a file, URL, or pasted document. The Skill dereferences it with swagger-parser, maps each operation to an MCP tool with a zod schema, scaffolds a project with create-mcp-use-app, and wires auth through environment variables.
Swagger 2.0 specs are first converted to OpenAPI 3 using the swagger2openapi CLI, then processed like any OpenAPI 3.x document. Each operation becomes one MCP tool with parameters merged into a single zod schema.
Yes, it supports apiKey, HTTP bearer, HTTP basic, and OAuth2 bearer schemes declared in the spec's securitySchemes. Secrets are read from environment variables like API_KEY or BEARER_TOKEN and never committed or placed in the conversation.
Yes, for specs over roughly 30 operations the Skill asks you to filter by tag, path prefix, explicit operation list, or HTTP method. The filter is written into index.ts as a visible constant you can edit later.
Usually the operation filter in index.ts excluded everything, or openapi.dereferenced.json is missing or stale. Re-run the load-spec script, check the filter constants, and verify the inspector URL has the server parameter correctly URL-encoded.
Avoid it for GraphQL or gRPC services, for designing a brand-new API from scratch, or when the goal is a widget-driven MCP App where most tools render custom UI. The schema converter and templates are OpenAPI-specific.
0xtaoistGenerate Swagger/OpenAPI documentation for .NET and Python APIs.
tsenseiMonitor a live URL for console errors, performance changes, and page failures.
lucasfthBuild MCP apps with interactive UI widgets and inline resources.
qwwiwiDesign OpenAPI-first REST APIs and convert endpoints into MCP primitives.
