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.json2. Keys
“The MCP server is available at the following URL on any running MockServer instance — no additional configuration is required”
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.
mock-server.com/mock_server/ai_mcp_setup.html3. Runs
Checked: no remote; it runs locally on your machine.
github.com/mock-server/mockserver-monorepo4. Commercial use
“Apache License Version 2.0, January 2004”
Apache 2.0 allows using it to test paid products.
github.com/mock-server/mockserver-monorepo/blob/d68a943b88569d0fdfa6ed275ccbc31cde186c75/LICENSE.mdChecked 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
Tools it gives your agent (46)
What it sends and its license
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.
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.
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.
Apache 2.0 allows using it to test paid products.
“Apache License Version 2.0, January 2004” source
Use it in tests for client projects; keep it out of production.
“MockServer is designed for development, testing, and QA environments only.” source
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
9.4.0 in the registry, updated Nov 20, 2026
9.2.0 (2026-10-26)
Alternatives
mock This page
msw
Pick it if you only fake requests inside a JavaScript app's tests or browser
Pick it if you want tests generated from OpenAPI, Postman or real traffic
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/mcpdocker run -i --rm docker.io/mockserver/mockserver:9.4.0{
"mcpServers": {
"mockserver": {
"type": "streamable-http",
"url": "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
The connector lives inside a running MockServer; there is nothing to connect to otherwise.
create_expectation rejects parameters outside its small input list.
It calls the real provider with your key, so it costs money and gives changing results.
Headers are redacted, message bodies are not.
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.