mcp-mock: deterministic open-source mock MCP server for testing clients and agents
OkSkirt1039 · reddit · 2026-11-18
mcp-mock (MIT) is a mock MCP server that official SDKs can't distinguish from a real one — just point your client's URL at it.
Key features:
- Deterministic fake data: 22 tools (weather, stocks, users, files, email...) with results derived from argument hashes, so snapshot tests just work;
- Test-controlled responses: force any result, JSON-RPC error, or HTTP failure (503, 429 with Retry-After) via meta or headers;
- Every spec revision: 2024-11-05 through 2026-07-28, including legacy HTTP+SSE transport, with per-revision pinning;
- Built-in OAuth: PKCE, refresh tokens, dynamic client registration, plus provable denials and expired tokens;
- Intentional failure paths: e.g. city: "Atlantis" always fails.
Every message is validated against the official schema.json of its revision and endpoints are exercised via the official TypeScript SDK. Try the free public instance (no signup) or self-host with docker run ghcr.io/axium-lab/mcp-mock:0.1.0. Not yet supported: stdio and legacy-revision sessions.
More from coding & agent
- Probabl lays out 6 agent reliability terms every data scientist should know — GaelVaroquaux · 2026-11-18
- OTel Node.js SDK lands 1-line change: Object.keys swap gives 2.4x speedup — DanielLockyer · 2026-11-18
- Raycast Launches Local MCP Server So Claude, Codex and Cursor Can Drive Your Mac — dean_rie · 2026-11-18
- Open-source speech-to-speech cuts voice agent history to exactly what you heard on interrupt — andimarafioti · 2026-11-18
- Academic Research Skills for Claude Code hits 57.5k GitHub stars — adnan_hashmi · 2026-11-18
- Google paper: gated self-improving agent harnesses cut token cost 10x and transfer across models — omarsar0 · 2026-11-18