7 months ago
Use any OpenAPI specification to expose an MCP server.
Handle OAuth2, bearer tokens, parameters and request bodies.
Fine tune the tools names and description with adhoc OpenAPI extensions.
Overview
What is openapi-to-mcp?
openapi-to-mcp is a tool that allows you to expose your API's endpoints as strongly typed tools using your OpenAPI specification.
How to use openapi-to-mcp?
To use openapi-to-mcp, install it as a Nuget tool or download the executables from the releases. Then, run the command with your OpenAPI specification URL or file as an argument.
Key features of openapi-to-mcp?
- Supports OpenAPI versions 2.0 and 3.0
- Accepts specifications in JSON and YAML formats
- Handles local and remote $refs
- Provides support for various API authorization methods including Bearer Token and OAuth2
- Generates tools based on operationId and descriptions from the OpenAPI spec
Use cases of openapi-to-mcp?
- Creating strongly typed API clients from OpenAPI specifications.
- Simplifying API integration for developers by providing a clear interface.
- Automating the generation of API documentation and tools.
FAQ from openapi-to-mcp?
- What is the installation process?
You can install openapi-to-mcp as a Nuget tool or download executables from the releases page.
- What formats does openapi-to-mcp support?
It supports both JSON and YAML formats for OpenAPI specifications.
- Can I use it with OAuth2?
Yes, openapi-to-mcp supports OAuth2 authorization flows.
Server Config
{
"mcpServers": {
"petstore": {
"command": "openapi-to-mcp",
"args": [
"https://petstore3.swagger.io/api/v3/openapi.json"
]
}
}
}