trackmcp
Back to directory
blackkspydo

openapi-mcp

View on GitHub

Openapi MCP

3 stars TypeScriptOthers Updated Dec 13, 2025

Documentation

OpenAPI MCP Server

An MCP server that lets LLMs inspect and interact with OpenAPI specifications.

Features

  • Load OpenAPI specs from URL or file (OpenAPI 2.0 & 3.x)
  • List and search endpoints
  • Get request/response schemas (fully dereferenced)
  • Validate payloads against schemas
  • Generate sample request payloads
  • Generate TypeScript types from schemas
  • Extract authentication schemes

Installation

Via npm (recommended)

bash
npm install -g @blackkspydo/openapi-mcp

Or run directly with npx:

bash
npx --yes @blackkspydo/openapi-mcp

From source

bash
git clone https://github.com/blackkspydo/openapi-mcp.git
cd openapi-mcp
bun install
bun run build

Usage

With Claude CLI

bash
claude mcp add openapi-mcp -- npx --yes @blackkspydo/openapi-mcp

With Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

json
{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["--yes", "@blackkspydo/openapi-mcp"]
    }
  }
}

Or if installed globally:

json
{
  "mcpServers": {
    "openapi-mcp": {
      "command": "openapi-mcp"
    }
  }
}

Standalone

bash
openapi-mcp
# or
npx --yes @blackkspydo/openapi-mcp

Available Tools

ToolDescription
`load_spec`Load an OpenAPI spec from URL or file
`list_endpoints`List all endpoints with optional filtering
`search_endpoints`Search endpoints by keyword
`get_endpoint_details`Get full details for an endpoint
`get_request_schema`Get request body schema
`get_response_schema`Get response schema by status code
`validate_payload`Validate JSON against schema
`generate_sample`Generate sample request payload
`generate_typescript_types`Generate TypeScript interfaces from schemas
`generate_curl`Generate ready-to-use cURL command
`get_auth_schemes`Get security schemes
`get_servers`Get available API servers

Example

code
You: Load the Petstore API spec from https://petstore.swagger.io/v2/swagger.json

You: List all POST endpoints

You: Generate TypeScript types for the Pet schema

You: Generate a cURL command for POST /pet

You: Generate a sample request for POST /pet

License

MIT

Frequently asked questions

What is openapi-mcp?

openapi-mcp is Openapi MCP

How do I install openapi-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is openapi-mcp open source?

Yes — it is hosted on GitHub at https://github.com/blackkspydo/openapi-mcp and has 3 stars.

Related MCP tools

modelcontextprotocolservers

Model Context Protocol Servers

90,051 TypeScript
bytedanceUI-TARS-desktop

The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra

38,840 TypeScript
agentvlmvision+11
czlonkowskin8n-mcp

A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you

22,825 TypeScript
mcpmcp-servern8n+1
glipsFigma-Context-MCP

MCP server to provide Figma layout information to AI coding agents like Cursor

15,766 TypeScript
aicursorfigma+2
elie222inbox-zero

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

12,148 TypeScript
aiemailnextjs+14
instantdbinstant

Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams — everything you need to ship apps your users will love.

10,507 TypeScript

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP