Use your OpenAPI specification to expose your API's endpoints as strongly typed tools. Basic example for https://petstore3.swagger.io/ 🎉 More complex example, using Github's API: This example use the bearer token auth (with a Github Personal Access Token) and force the tool naming strategy to "verb and path", as Github's operation ids are not valid tool names. As a Nuget tool: openapi-to-mcp Or d
Add this skill
npx mdskills install ouvreboite/openapi-to-mcpDynamically converts OpenAPI specs into MCP tools with clear setup and working examples
Use your OpenAPI specification to expose your API's endpoints as strongly typed tools.
Basic example for https://petstore3.swagger.io/ 🎉
{
"mcpServers": {
"petstore": {
"command": "openapi-to-mcp",
"args": [
"https://petstore3.swagger.io/api/v3/openapi.json"
]
}
}
}
More complex example, using Github's API:
{
"mcpServers": {
"github": {
"command": "openapi-to-mcp",
"args": [
"https://raw.githubusercontent.com/github/rest-api-description/refs/heads/main/descriptions/api.github.com/api.github.com.yaml",
"--bearer-token",
"github_pat_xxxxxx",
"--tool-naming-strategy",
"verbandpath"
]
}
}
}
This example use the bearer token auth (with a Github Personal Access Token) and force the tool naming strategy to "verb and path", as Github's operation ids are not valid tool names.
As a Nuget tool: openapi-to-mcp
dotnet tool install --global openapi-to-mcp
Or download the executables from the releases
Usage:
openapi-to-mcp [options]
Arguments:
You OpenAPI specification (URL or file) [required]
Options:
-t, --tool-naming-strategy How the tool name should be computed [default: extension_or_operationid_or_verbandpath]
-h, --host-override Host override
-b, --bearer-token Bearer token
-o2, --oauth-2-grant-type OAuth2 flow to be used
-o2_tu, --oauth-2-token-url OAuth2 token endpoint URL (override the one defined in your OpenAPI for your chosen OAuth2 flow)
-o2_ci, --oauth-2-client-id OAuth2 client id (for the client_credentials grant_type)
-o2_cs, --oauth-2-client-secret OAuth2 client secret (for the client_credentials grant_type)
-o2_rt, --oauth-2-refresh-token OAuth2 refresh token (for the refresh_token grant_type)
-o2_un, --oauth-2-username OAuth2 username (for the password grant_type)
-o2_pw, --oauth-2-password OAuth2 password (for the password grant_type)
-i, --instructions MCP instruction to be advertised by the server
--verbose Log more info (in sdterr) [default: False]
-?, -h, --help Show help and usage information
--version Show version information
A set of custom extensions is available to customize how your API should be exposed:
info.x-mcp-instructions (string): Textual instructions exposed by the MCP server during the initialize handshakeoperation.x-mcp-tool-name (string): Custom tool nameoperation.x-mcp-tool-description (string): Custom tool descriptionoperation.x-mcp-tool-enabled (boolean): Enabled/disabled a specific operation (enabled by default)Only STDIO transport is currently supported.
Operations ("endpoints") from your OpenAPI specification are translated to MCP tools
operation.x-mcp-tool-name extension, then the operation.operationId and then {httpMethod}_{escaped_path}
--tool-naming-strategy option.^[a-zA-Z0-9_-]{1,64}$operation.x-mcp-tool-description ?? operation.description ?? path.descriptionWhen a tool is called, the MCP server will call the underlying endpoint. To determine which host to call a combination of parameters are used:
--host-override optionFor example running openapi-to-mcp https://petstore3.swagger.io/api/v3/openapi.json:
A token can be provided as option --bearer-token. It'll be provided to all calls as the Authorization: Bearer {token} header.
It'll also be provided when fetching a remote specification.
ClientCredentials, RefreshToken, Password are supported.
If your OpenAPI specification declare securitySchemes for those flows, the corresponding tokenUrl will be used.
Create a new tag/release 🤷
Install via CLI
npx mdskills install ouvreboite/openapi-to-mcpOpenapi To MCP is a free, open-source AI agent skill. Use your OpenAPI specification to expose your API's endpoints as strongly typed tools. Basic example for https://petstore3.swagger.io/ 🎉 More complex example, using Github's API: This example use the bearer token auth (with a Github Personal Access Token) and force the tool naming strategy to "verb and path", as Github's operation ids are not valid tool names. As a Nuget tool: openapi-to-mcp Or d
Install Openapi To MCP with a single command:
npx mdskills install ouvreboite/openapi-to-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Openapi To MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.