OpenAPI Toolkit for MCP

OpenAPI Toolkit for MCP

Fetch, validate, and generate code or curl from any OpenAPI or Swagger spec - all from a single URL.

827

5 Tools

Packaged by

Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Overview Tools (5)Config Manual installation

Docker Hub⁠Github repository⁠

Use cases

Generate a C# code snippet for a given operation ID from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.

Generate a cURL command for a given operation ID from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.

Analyze an OpenAPI or Swagger document provided as a URL OR a raw JSON string or file contents, and list possible HTTP responses (status codes and descriptions) for the specified operation ID.

Retrieve a list of operations (endpoints) from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.

Analyze and validate an OpenAPI or Swagger document provided as a URL OR a raw JSON string or file contents, and list possible errors, issues and problems with specification for the specified operation ID.

About

OpenAPI Toolkit for MCP MCP Server

Fetch, validate, and generate code or curl from any OpenAPI or Swagger spec - all from a single URL.

What is an MCP Server?⁠

Characteristics

Attribute	Details
Docker Image	mcp/openapi⁠
Author	lepoco⁠
Repository	https://github.com/lepoco/openapi.client⁠
Dockerfile	https://github.com/lepoco/openapi.client/blob/main/Dockerfile⁠
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/openapi --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	MIT License

Available Tools (5)

Tools provided by this Server	Short Description
`create_csharp_snippet`	Generate a C# code snippet for a given operation ID from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.
`generate_curl_command`	Generate a cURL command for a given operation ID from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.
`get_known_responses`	Analyze an OpenAPI or Swagger document provided as a URL OR a raw JSON string or file contents, and list possible HTTP responses (status codes and descriptions) for the specified operation ID.
`get_list_of_operations`	Retrieve a list of operations (endpoints) from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.
`validate_document`	Analyze and validate an OpenAPI or Swagger document provided as a URL OR a raw JSON string or file contents, and list possible errors, issues and problems with specification for the specified operation ID.

Tools Details

Tool: `create_csharp_snippet`

Generate a C# code snippet for a given operation ID from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.

Parameters	Type	Description
`addressOrFileContents`	`string`	URL address of the OpenAPI or Swagger JSON document OR raw JSON contents of the OpenAPI or Swagger specification. Can be provided as text or from a file.
`baseAddress`	`string`	Optional base URL to be used in the generated cURL command.
`operationId`	`string`	Operation ID for which to create a snippet.

Tool: `generate_curl_command`

Generate a cURL command for a given operation ID from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.

Parameters	Type	Description
`addressOrFileContents`	`string`	URL address of the OpenAPI or Swagger JSON document OR raw JSON contents of the OpenAPI or Swagger specification. Can be provided as text or from a file.
`baseAddress`	`string`	Optional base URL to be used in the generated cURL command.
`operationId`	`string`	Operation ID for which to generate the cURL command.

Tool: `get_known_responses`

Analyze an OpenAPI or Swagger document provided as a URL OR a raw JSON string or file contents, and list possible HTTP responses (status codes and descriptions) for the specified operation ID.

Parameters	Type	Description
`addressOrFileContents`	`string`	URL address of the OpenAPI or Swagger JSON document OR raw JSON contents of the OpenAPI or Swagger specification. Can be provided as text or from a file.
`operationId`	`string`	Operation ID for which to retrieve known responses.

Tool: `get_list_of_operations`

Retrieve a list of operations (endpoints) from a URL OR a raw JSON string or file contents pointing to an OpenAPI or Swagger JSON document.

Parameters	Type	Description
`addressOrFileContents`	`string`	URL address of the OpenAPI or Swagger JSON document OR raw JSON contents of the OpenAPI or Swagger specification. Can be provided as text or from a file.

Tool: `validate_document`

Analyze and validate an OpenAPI or Swagger document provided as a URL OR a raw JSON string or file contents, and list possible errors, issues and problems with specification for the specified operation ID.

Parameters	Type	Description
`addressOrFileContents`	`string`	URL address of the OpenAPI or Swagger JSON document OR raw JSON contents of the OpenAPI or Swagger specification. Can be provided as text or from a file.

Use this MCP Server

{
  "mcpServers": {
    "openapi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MODE",
        "mcp/openapi"
      ],
      "env": {
        "MODE": "Stdio"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Manual installation

You can install the MCP server using:

Installation for

Related servers