One binary. Seven protocols. Zero dependencies.
Mock HTTP, gRPC, GraphQL, WebSocket, MQTT, SSE, and SOAP APIs from a single CLI tool. Import from OpenAPI, Postman, WireMock, HAR, or cURL. Share mocks instantly via built-in cloud tunneling.
| mockd | WireMock | Mockoon | json-server | Prism | MockServer | |
|---|---|---|---|---|---|---|
| Single binary, no runtime | ✅ | ❌ JVM | ❌ Node | ❌ Node | ❌ Node | ❌ JVM |
| HTTP mocking | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| gRPC mocking | ✅ | 🔌 Ext | ❌ | ❌ | ❌ | ✅ |
| GraphQL mocking | ✅ | 🔌 Ext | ❌ | ❌ | ❌ | ❌ |
| WebSocket mocking | ✅ | 🔌 Ext | ❌ | ❌ | ❌ | ❌ |
| MQTT broker | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| SOAP mocking | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ |
| SSE streaming | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| OAuth/OIDC provider | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Chaos engineering | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Stateful CRUD | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
| Cloud tunnel sharing | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
| Proxy recording & replay | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ |
| Import OpenAPI/Postman/HAR | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
| Built-in web dashboard | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
| MCP server (AI-native) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
🔌 Ext = available via separate extension JAR, not bundled with WireMock core. mockd includes all protocols natively in a single binary.
# Quick install
curl -sSL https://get.mockd.io | sh
# Homebrew
brew install getmockd/tap/mockd
# Docker
docker run -p 4280:4280 -p 4290:4290 ghcr.io/getmockd/mockd:latest
# Go
go install github.com/getmockd/mockd/cmd/mockd@latestPre-built binaries for Linux, macOS, and Windows are available on the Releases page.
# Start the mock server
mockd start
# Mock an HTTP endpoint
mockd add http --path /api/users --body '[{"id": 1, "name": "Alice"}]'
# Test it
curl http://localhost:4280/api/users
# → [{"id": 1, "name": "Alice"}]
# Mock a GraphQL API
mockd add graphql --path /graphql --operation users \
--response '[{"id": 1, "name": "Alice"}]'
# Mock a gRPC service
mockd add grpc --proto ./service.proto \
--service myapp.UserService --rpc-method GetUser \
--response '{"id": 1, "name": "Alice"}'
# Mock a WebSocket endpoint
mockd add websocket --path /ws/chat --echo
# Import from OpenAPI, Postman, or cURL
mockd import openapi.yaml
mockd import collection.json
mockd import "curl -X GET https://api.example.com/users"Mock seven protocols from a single tool with a unified CLI and Admin API:
| Protocol | Port | Example |
|---|---|---|
| HTTP/HTTPS | 4280 | mockd add http --path /api/hello --body '{"msg":"hi"}' |
| gRPC | 50051 | mockd add grpc --proto svc.proto --service Greeter --rpc-method Greet |
| GraphQL | 4280 | mockd add graphql --path /graphql --operation hello |
| WebSocket | 4280 | mockd add websocket --path /ws --echo |
| MQTT | 1883 | mockd add mqtt --topic sensors/temp --payload '{"temp":72}' |
| SSE | 4280 | mockd add http --path /events --sse --sse-event 'data: hello' |
| SOAP | 4280 | mockd add soap --path /soap --operation GetWeather --response '<OK/>' |
Bring your existing API definitions — no rewriting needed:
mockd import openapi.yaml # OpenAPI 3.x / Swagger 2.0
mockd import collection.json # Postman collections
mockd import recording.har # HAR files
mockd import wiremock-mapping.json # WireMock stubs
mockd import service.wsdl # WSDL → SOAP mocks
mockd import "curl -X GET https://api.example.com/users" # cURL commands
mockd export --format yaml > mocks.yamlShare local mocks with your team instantly. All protocols routed through a single QUIC connection on port 443:
mockd tunnel enable
# → https://a1b2c3d4.tunnel.mockd.io → http://localhost:4280Test how your app handles failures:
# Apply a built-in chaos profile at startup
mockd serve --chaos-profile flaky --config mockd.yaml
# Or enable chaos at runtime
mockd chaos apply slow-apiSimulate CRUD resources with automatic ID generation, pagination, and persistence. Import an API spec and bind its endpoints to stateful tables with the tables+extend pattern:
# mockd.yaml — tables + extend (recommended for config files)
version: "1.0"
imports:
- path: openapi.yaml
as: api
tables:
- name: users
seedData:
- { id: "1", name: "Alice", email: "[email protected]" }
extend:
- { mock: api.GetUsers, table: users, action: list }
- { mock: api.PostUsers, table: users, action: create }
- { mock: api.GetUsersId, table: users, action: get }Tables are pure data stores (no routing, no basePath). Extend bindings wire imported mock endpoints to table CRUD actions (list, get, create, update, delete). Custom operations are also supported via action: custom + operation: OpName.
State is shared across protocols — REST and SOAP can operate on the same table:
# Cross-protocol stateful mocking
tables:
- name: users
seedData:
- { id: "1", name: "Alice", email: "[email protected]" }
mocks:
- type: soap
soap:
path: /soap/UserService
operations:
GetUser:
statefulResource: users # Same data as REST!
statefulAction: getFor quick CLI prototyping, mockd add http --path /api/users --stateful still works to auto-create CRUD endpoints.
Isolated environments for mocks, stateful resources, and request logs. Run multiple API environments from a single mockd instance with --workspace scoping:
mockd workspace create -n "Payment API" --use
mockd import stripe-openapi.yaml
mockd workspace create -n "Comms API" --use
mockd import twilio-openapi.yamlRecord real API traffic and replay it as mocks:
mockd proxy start --port 8888
# Configure your app to use http://localhost:8888 as proxy
# Traffic is recorded, then replay with:
mockd import recordings/session-name.jsonFull REST API for dynamic mock management at runtime:
# Create a mock
curl -X POST http://localhost:4290/mocks \
-H "Content-Type: application/json" \
-d '{"type":"http","http":{"matcher":{"method":"GET","path":"/health"},"response":{"statusCode":200,"body":"{\"status\":\"ok\"}"}}}'
# List mocks
curl http://localhost:4290/mocks
# Import OpenAPI spec
curl -X POST http://localhost:4290/import \
-H "Content-Type: application/x-yaml" \
--data-binary @openapi.yamlRelease builds include a built-in web UI served from the admin port:
mockd start
# Open http://localhost:4290 in your browserManage mocks for all 7 protocols visually with a VS Code-style tabbed editor, command palette (Ctrl+K), mock tree with search/sort/folders, request log viewer with near-miss debugging, and more. Docker images and all release packages include the dashboard automatically.
mockd includes a built-in Model Context Protocol server with 18 tools for full mock lifecycle management from AI-powered editors (Cursor, Windsurf, Claude Code):
mockd mcp # Start the MCP server (stdio transport)Tools cover mock CRUD, import/export, chaos engineering (10 built-in profiles), mock verification, stateful resource management, custom operations, and multi-environment context switching.
Configure via flags, environment variables, or config files:
# .mockdrc.yaml
port: 4280
adminPort: 4290
httpsPort: 5280
maxLogEntries: 1000| Variable | Description | Default |
|---|---|---|
MOCKD_PORT |
Mock server port | 4280 |
MOCKD_ADMIN_PORT |
Admin API port | 4290 |
MOCKD_HTTPS_PORT |
HTTPS port (0=disabled) | 0 |
MOCKD_CONFIG |
Config file path |
mockd.io — Full documentation, guides, and API reference.
See CONTRIBUTING.md for development setup and guidelines.