OpenAPI Schema

OpenAPI Schema

Allow LLMs to explore large OpenAPI schemas without bloating the context.

46
Stars
10
Forks
0
Releases

Overview

OpenAPI Schema MCP Server is an MCP server that exposes OpenAPI schema information to LLMs and tools. It lets you load any OpenAPI schema file (JSON or YAML) from the command line and then interrogate the schema with a suite of specialized tools. Users can list endpoints and their HTTP methods with summaries, inspect a specific endpoint in detail (parameters, request bodies, and responses), and fetch request body schemas. It can retrieve response schemas for particular status codes and obtain path parameters. It can also list and fetch component definitions (schemas, parameters, responses) and their examples, list security schemes, and get examples tied to components or endpoints. A search tool lets you scan paths, operations, and schemas across the entire specification. For readability, responses can be returned in YAML format. The server is designed to work with Claude Desktop and Claude Code workflows, enabling seamless integration into AI-assisted API exploration while keeping the OpenAPI spec offloaded from large contexts.

Details

Owner
hannesj
Language
JavaScript
License
Updated
2025-12-07

Features

Load OpenAPI schema

Load any JSON or YAML OpenAPI schema via command line argument.

Explore API structure

Browse API paths, operations, parameters, and schemas.

View request and response schemas

View detailed request and response schemas.

Inspect and lookup components

Look up component definitions and examples in the spec.

Search across API

Search across the entire API specification.

YAML responses

Get responses in YAML format for improved readability.

Audience

LLMsEnable LLMs to reason about and explore large OpenAPI specifications.
Claude usersIntegrate the MCP server with Claude Desktop or Claude Code to explore APIs.
DevelopersUse the MCP server to integrate OpenAPI exploration into developer tooling.

Tags

OpenAPIschemaMCPLLMAPItoolscomponentssecurityyamljson