Skip to main content
MCP server CX Codex

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 GitHub

What 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.json and build a cURL call for creating an order.
  • Validate google.youtube.api.json before I commit it.
  • Which responses does getUser declare?

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.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open