Openapi MCP

★ 3

from blackkspydo

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

🔥🔥🔥🔥✓ VerifiedFreeQuick setup

#git #security

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

Available Tools

Tool	Description
`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

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

Installation

Via npm (recommended)

npm install -g @blackkspydo/openapi-mcp

Or run directly with npx:

npx --yes @blackkspydo/openapi-mcp

From source

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

Usage

With Claude CLI

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

With Claude Desktop

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

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

Or if installed globally:

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

Standalone

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