mockserver-mcp
An MCP (Model Context Protocol) server for interacting with James Bloom's MockServer. This enables AI assistants to create mock HTTP expectations, verify requests, clear state, and manage MockServer instances programmatically.
Power your agent
The publisher's own command. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code has no install link for a local command. Copy the command below and run it in a terminal.
MOCKSERVER_HOST=<value> MOCKSERVER_PORT=<value> claude mcp add io.github.akkshay10-mcpclientmock -- npx -y mockserver-mcp@1.0.2Run in a terminal.
{ "mcpServers": { "io.github.akkshay10-mcpclientmock": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "MOCKSERVER_HOST": "<value>", "MOCKSERVER_PORT": "<value>" } } }}claude_desktop_config.json
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
An MCP (Model Context Protocol) server for interacting with James Bloom's MockServer. This enables AI assistants to create mock HTTP expectations, verify requests, clear state, and manage MockServer instances programmatically.
MCP server for James Bloom MockServer - create expectations, verify requests, and manage mock state
You need a running MockServer instance:
# Using Docker (easiest)
docker run -d -p 1080:1080 mockserver/mockserver
npx mockserver-mcp
npm install -g mockserver-mcp
mockserver-mcp
Add to your MCP client configuration file (e.g., Claude Desktop, Kiro, Cursor):
{
"mcpServers": {
"mockserver": {
"command": "npx",
"args": ["-y", "mockserver-mcp"],
"env": {
"MOCKSERVER_HOST": "localhost",
"MOCKSERVER_PORT": "1080"
}
}
}
}
For shared team MockServer, change MOCKSERVER_HOST to your server's address.
Create a mock HTTP expectation on MockServer.
Parameters:
httpRequest (required): Request matching criteria
method: HTTP method (GET, POST, PUT, DELETE, etc.)path: URL path to matchqueryStringParameters: Query parameters to matchheaders: Headers to matchbody: Body matcher with type (STRING, JSON, REGEX, XPATH, JSON_PATH) and valuehttpResponse: Response configuration
statusCode: HTTP status codeheaders: Response headersbody: Response body (string or object)delay: Response delay with timeUnit and valuetimes: How many times to match (remainingTimes, unlimited)timeToLive: Expectation lifetime (timeUnit, timeToLive)Example:
{
"httpRequest": {
"method": "GET",
"path": "/api/users"
},
"httpResponse": {
"statusCode": 200,
"body": { "users": [] }
}
}
Verify that requests matching criteria were received by MockServer.
Parameters:
httpRequest (required): Request matching criteria (same as create_expectation)times: Expected request count
atLeast: Minimum number of requestsatMost: Maximum number of requestsexactly: Exact number of requestsExample:
{
"httpRequest": {
"method": "POST",
"path": "/api/orders"
},
"times": {
"atLeast": 1
}
}
Clear expectations and recorded requests from MockServer.
Parameters:
httpRequest (optional): Request matcher to clear specific expectations. If not provided, clears all.Example:
{
"httpRequest": {
"path": "/api/users"
}
}
Perform a full reset of MockServer, clearing all expectations and recorded requests.
Parameters: None
Retrieve recorded requests from MockServer.
Parameters:
httpRequest (optional): Request matcher to filter recorded requestsExample:
{
"httpRequest": {
"method": "GET"
}
}
Get MockServer connection status and configuration.
Parameters: None
API mocking enables early testing — start building and testing your frontend or integrations before the backend is ready. No more waiting. Ship faster.
MIT
© 2026 MCP Directory.
MCP server for James Bloom MockServer - create expectations, verify requests, and manage mock state
{ "mcpServers": { "io.github.akkshay10-mcpclientmock": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "MOCKSERVER_HOST": "<value>", "MOCKSERVER_PORT": "<value>" } } }}Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
The publisher lists these environment variables: MOCKSERVER_HOST, MOCKSERVER_PORT.
MCPClientMock runs locally over stdio.
Last checked 2026-11-08. MCP server for James Bloom MockServer - create expectations, verify requests, and manage mock state