OpenAPI MCP Server logo

OpenAPI MCP Server

by snaggle-ai

A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org. It works by figuring out the OpenAPI identifier, requesting a summary, and determining which endpoints are needed.

View on GitHub

Last updated: N/A

What is OpenAPI MCP Server?

OpenAPI MCP Server is a Model Context Protocol (MCP) server designed to facilitate the discovery and understanding of OpenAPI specifications. It allows users to explore and retrieve information about various APIs through a simplified process.

How to use OpenAPI MCP Server?

The server can be installed via Smithery or npx. Once installed, you can ask Claude or Cursor to find information about specific APIs (e.g., 'Find information about the Stripe API'). The MCP server will then provide an overview and retrieve operation details as needed.

Key features of OpenAPI MCP Server

  • Get an overview of any OpenAPI specification

  • Retrieve details about specific API operations

  • Support for both JSON and YAML formats

  • Tested with Claude Desktop and Cursor

Use cases of OpenAPI MCP Server

  • Exploring and understanding new APIs

  • Generating code from OpenAPI specifications

  • Providing context to language models about available APIs

  • Quickly finding relevant API endpoints for a specific task

FAQ from OpenAPI MCP Server

Does OpenAPI MCP allow executing endpoints directly?

No, OpenAPI MCP v2 does not allow executing the endpoints as tools directly, as authentication isn't a solved problem with MCP yet.

Which versions of Node.js are supported?

Node.js version 16.17.0 or higher is required.

Which clients are supported?

Claude Desktop, Cursor, or any other MCP client are supported.

Where can I find the documentation for older versions of OpenAPI MCP?

You can access any version prior to v2.0.0 and their README is here

Is OpenAPI MCP v2 stable?

No, OpenAPI MCP v2 is a Work In Progress and may contain bugs.