OpenAPI Toolkit — Claude Code MCP server: what it does, install
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.
no license updated 2026-10-29
Open on GitHubWhat OpenAPI Toolkit 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.
What it helps with
- 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 for the agent
- List every operation ID in
google.youtube.api.jsonand build a cURL call for creating an order. - Validate
google.youtube.api.jsonbefore I commit it. - Which responses does
getUserdeclare?
How to install OpenAPI Toolkit
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenAPI Toolkit
How do I install OpenAPI Toolkit in Claude Code?
Build the image with docker buildx build ./ -t mcp/openapi --no-cache, then add a server entry to .mcp.json using docker as the command and run -i --rm mcp/openapi as the arguments.
What does OpenAPI Toolkit do?
It reads an OpenAPI or Swagger document for the agent: returns operation IDs and their documented responses, validates the spec, and produces a cURL call or C# request stub for one operation.
What does the server need to run?
Docker, since it ships as a container. HTTP mode is switched on at launch with MODE=Http and port 64622 mapped to 8080.