# mockd

> mockd is a multi-protocol API mock server that supports HTTP/REST, WebSocket, GraphQL, gRPC, SOAP, MQTT, SSE, and OAuth from a single Go binary. It includes an 18-tool MCP (Model Context Protocol) server for AI agent integration, a built-in admin API with ~168 endpoints, request logging, chaos engineering with 12 fault types, stateful CRUD resources, and imports from OpenAPI, Postman, HAR, WireMock, cURL, WSDL, and Mockoon formats.

Key facts:
- Written in Go, distributed as a single binary (<30MB, <10ms startup)
- Default mock server port: 4280, admin API port: 4290
- Config format: YAML (mockd.yaml)
- MCP server: `mockd mcp` (stdio) or `mockd serve --mcp` (HTTP)
- License: Apache 2.0 (core engine)
- 35 built-in faker types for dynamic response generation
- 10 chaos engineering profiles (slow-api, flaky, offline, mobile-3g, etc.)
- Seeded reproducible responses via `?_mockd_seed=42` query parameter
- Headless CI mode: `mockd engine --config mocks.yaml --port 0 --print-url`

## Docs

- [Quick Start](https://mockd.io/quickstart): Install mockd and create your first mock in 2 minutes
- [Features](https://mockd.io/features): Complete feature overview with all capabilities
- [CLI Reference](https://mockd.io/docs/reference/cli): All ~110 CLI commands and flags
- [Admin API Reference](https://mockd.io/docs/reference/admin-api): ~168 REST API endpoints
- [Configuration](https://mockd.io/docs/reference/configuration): Complete mockd.yaml schema reference
- [MCP Server Guide](https://mockd.io/docs/guides/mcp-server): Using mockd with AI agents via MCP (18 tools)
- [Response Templating](https://mockd.io/docs/guides/response-templating): 35 faker types, template variables, seeded responses
- [Chaos Engineering](https://mockd.io/docs/guides/chaos-engineering): 12 fault types, 10 profiles, circuit breaker, retry-after
- [Import/Export](https://mockd.io/docs/guides/import-export): Import from 8 formats (OpenAPI, Postman, HAR, WireMock, cURL, WSDL, Mockoon)
- [Request Matching](https://mockd.io/docs/guides/request-matching): 15+ matching criteria with near-miss debugging

## Protocols

- [HTTP/REST](https://mockd.io/protocols/http): Full HTTP mocking with matchers, templates, delays
- [GraphQL](https://mockd.io/protocols/graphql): Schema-aware GraphQL mocking
- [gRPC](https://mockd.io/protocols/grpc): gRPC service/method mocking
- [WebSocket](https://mockd.io/protocols/websocket): WebSocket endpoint mocking with scenarios
- [MQTT](https://mockd.io/protocols/mqtt): MQTT broker mocking with topic matching
- [SSE](https://mockd.io/protocols/sse): Server-Sent Events mocking
- [SOAP](https://mockd.io/protocols/soap): SOAP/WSDL mocking with WSDL import

## Examples

- [Basic Mocks](https://mockd.io/docs/examples/basic-mocks): Simple HTTP mock examples
- [CRUD API](https://mockd.io/docs/examples/crud-api): Stateful CRUD resource examples
- [Integration Testing](https://mockd.io/docs/examples/integration-testing): CI/CD with mockd engine and GitHub Action

## Comparisons

- [mockd vs WireMock](https://mockd.io/compare/wiremock): Feature comparison
- [mockd vs Postman](https://mockd.io/compare/postman): Feature comparison
- [mockd vs MSW](https://mockd.io/compare/msw): Feature comparison
- [mockd vs Prism](https://mockd.io/compare/prism): Feature comparison

## Optional

- [Pricing](https://mockd.io/pricing): Free open-source CLI + cloud plans
- [Changelog](https://mockd.io/changelog): Version history
- [GitHub](https://github.com/getmockd/mockd): Source code and issues