Openapi To MCP Server

@ouvreboite

Repository

Basic information

About Openapi To MCP Server

An MCP server for your API

#openapi #api

Openapi To MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "petstore": {
      "command": "openapi-to-mcp",
      "args": [
        "https://petstore3.swagger.io/api/v3/openapi.json"
      ]
    }
  }
}

Openapi To MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Openapi To Mcp?

Openapi To Mcp is a .NET tool that reads an OpenAPI specification and exposes each API endpoint as a strongly typed MCP tool, enabling AI assistants to interact with any REST API via the Model Context Protocol.

How to use Openapi To Mcp?

Install the .NET global tool via dotnet tool install --global openapi-to-mcp or download the pre-built executable from releases. Then configure your MCP client (e.g., Claude Desktop) with the command openapi-to-mcp <open-api> where <open-api> is a URL or file path to the OpenAPI specification. Additional options include authentication (bearer token, OAuth2), tool naming strategy, and host override.

Key features of Openapi To Mcp

Converts OpenAPI 2.0 and 3.0 specs (JSON/YAML) into MCP tools
Supports bearer token and OAuth2 (client_credentials, password, refresh_token)
Configurable tool naming strategy: operationId, verb+path, or extension
Custom OpenAPI extensions for instructions, tool name, description, and enable/disable
Only STDIO transport; local file or remote URL specs supported
Tools are discarded if name does not match ^[a-zA-Z0-9_-]{1,64}$

Use cases of Openapi To Mcp

Expose a private API to an MCP-compatible AI assistant without writing custom adapters
Quickly turn any public API with an OpenAPI spec into consumable tools for agents
Integrate GitHub API (or similar) with authentication into a Claude Desktop session
Enable AI to call your REST endpoints using strongly typed parameters from the spec

Frequently asked questions

Does Openapi To Mcp support OpenAPI 3.1?

No, currently only OpenAPI 2.0 and 3.0 are supported. 3.1 will be supported once the underlying OpenAPI.NET library adds support.

What runtime or dependencies are required?

The tool runs on .NET and is installed as a .NET global tool. Pre-built executables are also available for systems without .NET.

Which MCP transport is used?

Only STDIO transport is currently supported – no SSE or other transports.

How does authentication work?

You can provide a bearer token via `--bearer-token` (added as `Authorization: Bearer` header) or use OAuth2 with the appropriate options (client credentials, password, or refresh token). The tool can read token URLs from the OpenAPI specification.

Can I override the host that the tool calls?

Yes, use the `--host-override` option. If not provided, the host is determined from the spec’s server URL (first absolute URL) or the remote spec’s own host.

Comments

More Other MCP servers

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

ICSS

chokcoco

不止于 CSS

20.7K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K