# OpenAPI Toolkit

OpenAPI Toolkit — an MCP server that reads an OpenAPI or Swagger spec on request: lists operations, validates the document and writes cURL calls for a chosen operation ID.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: lepoco
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lepoco/openapi.client
- 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-toolkit

## What it does

OpenAPI Toolkit runs as a container and hands the agent a set of tools for reading an OpenAPI or Swagger document. `get_list_of_operations` returns the operation IDs, `get_known_responses` shows what responses each one declares, `validate_document` checks the structure. Two further tools write code: `generate_curl_command` and `create_csharp_snippet`.

Setup goes through Docker. Build the image with `docker buildx build ./ -t mcp/openapi --no-cache`, then register the server in `.mcp.json` so the client starts `docker run -i --rm mcp/openapi`. For HTTP transport, launch the same image with `-e MODE=Http -p 64622:8080`.

Docker has to be installed before any of this works, otherwise the client has nothing to start. The C# snippet tool pays off inside a .NET codebase; elsewhere the cURL output and the validation step carry the job.

## 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
- list every operation ID in a large spec
- validate an OpenAPI document before committing
- get a ready cURL call for one operation
- see which responses an operation declares
- scaffold a C# HTTP request from an operation ID

## Example prompts
- List every operation ID in `google.youtube.api.json` and build a cURL call for creating an order.
- Validate `google.youtube.api.json` before I commit it.
- Which responses does `getUser` declare?

## Similar
- [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
- [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
- [openapi](https://affpapa.org/en/nevibecode/skills/oakoss-openapi.md) — skill · 197 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
