Mockserver MCP Server

Mock, record/replay, verify and chaos-test any HTTP/REST/gRPC/LLM dependency over MCP.

Local serverstdioPython

What is the Mockserver MCP server?

Mockserver MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Mock, record/replay, verify and chaos-test any HTTP/REST/gRPC/LLM dependency over MCP.

What you get

MockServer is an HTTP(S) mock server and proxy for testing. It does three things:

Setting it up

Installation goes through your MCP client rather than a global install: point it at mockserver/mockserver on a container image and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What the assistant can call

Once Mockserver is connected, these are the calls the assistant has available:

  • OpenAPI — generate expectations directly from an OpenAPI/Swagger specification
  • Verification — assert which requests were received, in what order, and how many times
  • Postman — click the button above, or import examples/postman (guide)
  • Version — Date
  • Documentation — For usage guide please see: www.mock-server.com
  • Community — Discussions Issues, Bugs & Feature Requests Roadmap
  • Requirements — The Requirements tool exposed by this server
  • Versions — Maven Central contains the following MockServer artifacts under the org.mock-server groupId. Every artifact ships in two forms — -no-dependencies

Configuration and credentials

Runtime: MockServer 6.x requires Java 17+. The minimum was raised from Java 11 as part of the Jakarta EE 10 / Spring 7 platform modernisation — see the Java 17 / Jakarta upgrade guide. If you are still on Java 11, pin to the 5.15.x line (no longer receiving security updates). The official Docker image already bundles a Java 17 runtime.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mockserver mcp server does with a few real requests.

Choosing this one

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Mockserver's toolset — OpenAPI, Verification, Postman and 5 more — is a fair guide to whether it matches your workflow. It is maintained by com.mock-server; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Mockserver's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
OpenAPIgenerate expectations directly from an OpenAPI/Swagger specification.
Verificationassert which requests were received, in what order, and how many times.
Postmanclick the button above, or import [examples/postman](examples/postman) ([guide](https://www.mock-server.com/where/postman.html)).
VersionDate
DocumentationFor usage guide please see: [www.mock-server.com](https://www.mock-server.com/)
Community<table> <tr> <td>Discussions</td> <td></td> </tr> <tr> <td>Issues, Bugs &amp; Feature Requests</td> <td></td> </tr> <tr> <td>Roadmap</td> <td></td> </tr> <tr> <td>Security</td> <td></td> </tr> </table>
RequirementsThe Requirements tool exposed by this server.
VersionsMaven Central contains the following MockServer artifacts under the org.mock-server groupId. Every artifact ships in two forms — -no-dependencies (shaded, zero transitive deps, **recommended**) and the plain form (transi

How to install the Mockserver MCP server

{
  "mcpServers": {
    "mockserver": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mockserver/mockserver"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Runtime: MockServer 6.x requires Java 17+. The minimum was raised from Java 11 as part of the Jakarta EE 10 / Spring 7 platform modernisation — see the Java 17 / Jakarta upgrade guide. If you are still on Java 11, pin to the 5.15.x line (no longer receiving security updates). The official Docker image already bundles a Java 17 runtime.

Example prompts to try

  • Use Mockserver to OpenAPI.
  • Use Mockserver to Verification.
  • Use Mockserver to Postman.

Frequently asked questions

It connects Mockserver to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (OpenAPI, Verification, Postman, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Mockserver directly.