# OpenAPI Schema

OpenAPI Schema — an MCP server that exposes OpenAPI specs in JSON or YAML to LLMs. It helps assistants inspect endpoints, query parameters, and schema definitions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: slimslenderslacks
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/slimslenderslacks/mcp-openapi-schema
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/openapi-schema

## What it does

The server gives coding assistants access to OpenAPI files stored in JSON or YAML format. Models can query route details, inspect request payloads, verify path parameters, and look up authentication methods. Tool responses return in YAML.

Execution relies on `npx`. Omitting a file path forces the process to search for `openapi.yaml` in the current directory. You can also pass a relative or absolute path as an argument.

Working with multiple distinct specs requires registering separate server instances under unique names. Configuration scope can be set to project or global level.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- inspect route definitions and HTTP methods in API specs
- view request body and response schemas by status code
- look up component objects and usage examples
- search across full API definitions for specific entities

## Example prompts
- Show me the parameters for the `GET /pets/{petId}` route.
- What does the payload schema look like for creating a pet?
- Search this specification for anything related to `user`.

## Similar
- [openapi-generator](https://affpapa.org/en/nevibecode/skills/openapi-generator.md) — skill · 320 installs
- [openapi-expert](https://affpapa.org/en/nevibecode/skills/openapi-expert.md) — skill · 282 installs
- [swagger-contract-testing-openapi-parser](https://affpapa.org/en/nevibecode/plugins/swagger-contract-testing-openapi-parser.md) — plugin · ★ 7 repo stars
- [route-to-openapi](https://affpapa.org/en/nevibecode/skills/route-to-openapi.md) — skill · ★ 4719 repo stars
- [spring-boot-openapi-documentation](https://affpapa.org/en/nevibecode/skills/spring-boot-openapi-documentation.md) — skill · 4200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
