OpenAPI MCP Server

@ivo-toby

Basic information

About OpenAPI MCP Server

MCP Server (Model Context Protocol) for turning OpenAPI specifications into a MCP Resource

OpenAPI MCP Server config

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

{
  "mcpServers": {
    "mcp-openapi-server": {
      "command": "npx",
      "args": [
        "@ivotoby/openapi-mcp-server",
        "\\"
      ]
    }
  }
}

OpenAPI 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.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is OpenAPI MCP Server?

A Model Context Protocol (MCP) server that exposes OpenAPI endpoints as MCP tools, with optional support for MCP prompts and resources. It enables Large Language Models to discover and interact with REST APIs defined by OpenAPI specifications.

How to use OpenAPI MCP Server?

Use the CLI directly with npx @ivotoby/openapi-mcp-server or import the OpenAPIServer class as a library in your Node.js application. Configure via environment variables (e.g., API_BASE_URL, OPENAPI_SPEC_PATH) or command‑line flags (e.g., --api-base-url, --openapi-spec). Supports both stdio (default) and HTTP transport.

Key features of OpenAPI MCP Server

Exposes OpenAPI endpoints as MCP tools automatically
Supports loading OpenAPI specs via URL, file, stdin, or inline
Two transports: stdio (default) and Streamable HTTP
Mutual TLS (mTLS) support for upstream API authentication
Tool loading modes: all, dynamic, or explicit
Filtering by tags and custom headers

Use cases of OpenAPI MCP Server

Connect Claude Desktop to any REST API via OpenAPI spec
Allow LLMs to dynamically discover and invoke API actions
Provide structured tools for API‑driven autonomous agents
Load private APIs using mTLS or custom CA certificates
Use with Cursor or any MCP‑compatible client

Frequently asked questions

What transport methods does OpenAPI MCP Server support?

Stdio (default) for direct integration with AI systems like Claude Desktop, and Streamable HTTP for web clients and HTTP‑capable systems.

How can I load an OpenAPI specification?

Four methods: provide a URL or local file path with `--openapi-spec`, pipe the spec via standard input with `--spec-from-stdin`, pass the spec inline with `--spec-inline`, or use the corresponding environment variables. Only one source is allowed at a time.

How do I authenticate to the upstream API?

You can set static headers via `--headers` / `API_HEADERS`, or use mutual TLS with `--client-cert` and `--client-key` options. mTLS is orthogonal to header‑based authentication.

What is the default transport and how do I change it?

The default transport is `stdio`. Switch to HTTP by setting `--transport http` (or the `TRANSPORT_TYPE` environment variable). The HTTP server listens on `127.0.0.1:3000` by default.

Can I use OpenAPI MCP Server as a library?

Yes. Import the `OpenAPIServer` class in your own Node.js applications for custom implementations, instead of using the CLI tool.

Comments

More Other MCP servers

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

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

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

ICSS

chokcoco

不止于 CSS

20.7K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K