Skip to content
Agents tracked: 502 Releases (7d): 762 Agent status: no reported issuesSince last limit reset: Claude 11d · Codex 9d For AI agents: Markdown Updated Nov 22, 2026

mock

by mock-server

fake the services your app calls, by asking.

Developer toolsOfficialLocal

GitHubWebsite

1. Made by

“"websiteUrl": "https://www.mock-server.com"”

The MCP server is built into MockServer itself; the repository belongs to the mock-server organization, whose site mock-server.com documents it.

github.com/mock-server/mockserver-monorepo/blob/d68a943b88569d0fdfa6ed275ccbc31cde186c75/server.json

Checked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error

What mock does

MockServer is a free test tool that stands in for the outside services your app talks to, such as a payment service or an AI model. Its built-in connector lets your AI assistant set up fake answers, record real traffic and check which calls your app made, all in plain words. It runs on your own computer, for example with Docker.

What people use it for

Fake a service that is not ready yet

Your app needs a health check or a partner's service that does not exist yet. Ask the assistant for a fake answer and keep building.

Record a real service, then replay it

Let real traffic pass through once and be recorded, then turn the recording into fakes. Tests then run without the real service.

Check that your app made the right calls

After a test, ask whether your app called the payment service exactly once, or in the right order.

Find out why a request got a 404

When a call hits no fake, the assistant shows the closest one and what to change, so you stop guessing.

Test your AI agent without paying for the model

Fake answers from OpenAI, Anthropic and other model providers, including failures and retries, so agent tests are free and repeatable.

Check a connector you built yourself

If you build your own MCP server, point this tool at it to check that it answers the protocol's basic calls correctly.

mock popularity

5,011
GitHub stars, mock-server/mockserver-monorepo
0
public agent projects connect it
mock: GitHub starsmock-server/mockserver-monorepo 5,011

Tools it gives your agent (46)

What it sends and its license

Sends

requests you choose to forward or proxy, including recorded AI model traffic

To the real host you set as the forward target; only in SPY or CAPTURE mode or with a forward expectation; SIMULATE answers from mocks only. Opt out: stay in SIMULATE mode and add no forward expectations.

Sends

replayed recordings and your provider key

To the live AI model provider of the configured backend; only when detect_llm_drift runs with a backend configured; otherwise it does nothing. Opt out: configure no runtime model backend.

Sends

test requests generated from your OpenAPI spec

To the service address you pass to run_contract_test or run_resiliency_test; only when those tools run. Opt out: point them only at your own test service.

MockServer is free and open source under the Apache 2.0 license, also for paid work. It is meant for testing only, never for a live public service.

In a paid app
Yes

Apache 2.0 allows using it to test paid products.

“Apache License Version 2.0, January 2004” source

client-work
Yes

Use it in tests for client projects; keep it out of production.

“MockServer is designed for development, testing, and QA environments only.” source

Pass on its files
With conditions

Copies of the code or image may be passed on under Apache 2.0, keeping its license and notices.

“TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION” source

Is it alive

Latest version

9.4.0 in the registry, updated Nov 20, 2026

Last release

9.2.0 (2026-10-26)

Remote endpoint
no remote; it runs locally on your machine

Alternatives

mock This page

5,011 starsLocal

msw

Pick it if you only fake requests inside a JavaScript app's tests or browser

Local

Keploy

Pick it if you want tests generated from OpenAPI, Postman or real traffic

19.9K starsRemote

All developer tools servers

Get started

Tell your AI assistant

“Start MockServer 9.2.0 in Docker on port 1080, connect its MCP server at http://localhost:1080/mockserver/mcp, mock GET /api/health with 200 OK, then verify my test called it exactly once.”

Connect it

claude mcp add mockserver --transport streamable-http http://localhost:1080/mockserver/mcp

Start MockServer first (docker run -d --rm -p 1080:1080 mockserver/mockserver). The setup page has no Codex section; any client that speaks Streamable HTTP can use the local address.

Mistakes to avoid

Adding the connector before MockServer is running
Start it first (docker run -d --rm -p 1080:1080 mockserver/mockserver), then add http://localhost:1080/mockserver/mcp

The connector lives inside a running MockServer; there is nothing to connect to otherwise.

Using create_expectation to match headers, cookies or a request body
Use raw_expectation with full MockServer JSON for those matches

create_expectation rejects parameters outside its small input list.

Running detect_llm_drift in every commit's test run
Run it in an opt-in or scheduled job, with a backend key set up on purpose

It calls the real provider with your key, so it costs money and gives changing results.

Committing fixture files from record_llm_fixtures without reading them
Pass redactBodyFields for body fields with secrets, then review the file

Headers are redacted, message bodies are not.

Exposing port 1080 of a shared or cloud machine to the internet
Keep it on localhost or a private test network

MockServer is a test tool with features that are unsafe on an open network.

Questions

Does it cost anything or need an account?

No. It is open source under Apache 2.0 and runs on your own machine; the connector needs no sign-in by default.

Which assistants does it work with?

The docs show setups for Cursor, Claude Code, Windsurf, Cline, Continue and OpenCode, plus code libraries such as LangChain.

Do I need Java?

Not with Docker; the image brings its own. The JAR needs Java 17 or newer.

Can I turn the connector off?

Yes. Set MOCKSERVER_MCP_ENABLED=false (or -Dmockserver.mcpEnabled=false); the default is on.