Happy slice of mcp pizzaMCP.pizza

mcp-openapi-server

MCP.Pizza Chef: ivo-toby

Many online tools publish a machine-readable list of everything they can do, and reading that list is the whole trick here: each action in the file becomes something your assistant can carry out for you. Point it at the file, add whatever sign-in header the service expects, and the actions show up. It suits people who already work with a documented internal or third-party service, and it is deliberately general rather than built for one task. It runs locally for Claude Desktop and Cursor, or over the network for shared use, and it is actively maintained.

Coding
Data

Use This MCP server To

Ask my assistant to run an action on a service I use Query an internal company system in plain language Pull up a record without learning the service's screens Limit which actions the assistant is allowed to run Try out a documented service before writing any code

README

OpenAPI MCP Server

smithery badge

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

📖 Documentation

  • User Guide - For users wanting to use this MCP server with Claude Desktop, Cursor, or other MCP clients
  • Library Usage - For developers creating custom MCP servers using this package as a library
  • Developer Guide - For contributors and developers working on the codebase
  • AuthProvider Guide - Detailed authentication patterns and examples

User Guide

This section covers how to use the MCP server as an end user with Claude Desktop, Cursor, or other MCP-compatible tools.

Overview

This MCP server can be used in two ways:

  1. CLI Tool: Use npx @ivotoby/openapi-mcp-server directly with command-line arguments for quick setup
  2. Library: Import and use the OpenAPIServer class in your own Node.js applications for custom implementations

The server supports two transport methods:

  1. Stdio Transport (default): For direct integration with AI systems like Claude Desktop that manage MCP connections through standard input/output.
  2. Streamable HTTP Transport: For connecting to the server over HTTP, allowing web clients and other HTTP-capable systems to use the MCP protocol.

Quick Start for Users

Option 1: Using with Claude Desktop (Stdio Transport)

mcp-openapi-server FAQ

Is it actively maintained?
Yes. The project was updated in mid-2026 and is still being worked on.
Do I need a key?
Usually yes, but not for this tool itself — you need whatever sign-in token the service you point it at requires.
Which apps does it work in?
Claude Desktop and Cursor are documented, and it can also be run over the network so several tools share one copy.
Can I use this to reach an internal company system?
Yes, provided that system publishes an OpenAPI file and you are allowed to call it. Certificates for private networks are supported.
How hard is setup?
This one leans developer. You supply the file location, the service's base address, and any sign-in headers before it will do anything.
Can I stop it doing something destructive?
Yes. You can load only the actions you name, or exclude whole groups, so everything else stays invisible to the assistant.