Skip to content
Back to search

mockd

High-performance, multi-protocol mock server. HTTP, WebSocket, gRPC, MQTT, SSE, GraphQL, SOAP in one binary.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/getmockd--mockd/badge.svg)](/listings/getmockd--mockd)

HTML

<a href="/listings/getmockd--mockd"><img src="/api/listings/getmockd--mockd/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

# Install
curl -sSL https://get.mockd.io | sh

# Start + create a stateful CRUD API in one command
mockd start
mockd add http --path /api/users --stateful users

# It works immediately
curl -X POST localhost:4280/api/users -d '{"name":"Alice","email":"alice@test.com"}'
# → {"id":"a1b2c3","name":"Alice","email":"alice@test.com"}

curl localhost:4280/api/users
# → {"data":[{"id":"a1b2c3","name":"Alice","email":"alice@test.com"}],"meta":{"total":1}}

<details> <summary><strong>More install options</strong></summary>

brew install getmockd/tap/mockd                                          # Homebrew
docker run -p 4280:4280 -p 4290:4290 ghcr.io/getmockd/mockd:latest      # Docker
go install github.com/getmockd/mockd/cmd/mockd@latest                    # Go

Pre-built binaries for Linux, macOS, and Windows on the [Releases](https://github.com/getmockd/mockd/releases) page. </details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 302 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://mockd.io"><img src="https://mockd.io/getmockd.svg" alt="mockd" width="200"></a>
  3. </p>
  4. <h3 align="center">One binary. Seven protocols. Zero dependencies.</h3>
  5. <p align="center">
  6. Mock HTTP, gRPC, GraphQL, WebSocket, MQTT, SSE, and SOAP from a single CLI tool.<br>
  7. Import OpenAPI specs. Build digital twins. Let AI agents create mocks for you.
  8. </p>
  9. <p align="center">
  10. <a href="https://github.com/getmockd/mockd/actions/workflows/ci.yaml"><img src="https://github.com/getmockd/mockd/actions/workflows/ci.yaml/badge.svg" alt="CI"></a>
  11. <a href="https://github.com/getmockd/mockd/releases"><img src="https://img.shields.io/github/v/release/getmockd/mockd?include_prereleases" alt="Release"></a>
  12. <a href="https://github.com/getmockd/mockd/stargazers"><img src="https://img.shields.io/github/stars/getmockd/mockd?style=social" alt="Stars"></a>
  13. <a href="https://go.dev"><img src="https://img.shields.io/badge/Go-1.25+-00ADD8?logo=go" alt="Go"></a>
  14. <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a>
  15. </p>
  16. <p align="center">
  17. <a href="https://mockd.io">Website</a> &middot;
  18. <a href="https://docs.mockd.io">Docs</a> &middot;
  19. <a href="https://github.com/getmockd/mockd-samples">Samples</a> &middot;
  20. <a href="https://github.com/getmockd/mockd/blob/main/CONTRIBUTING.md">Contributing</a>
  21. </p>
  22. <p align="center">
  23. <img src=".github/assets/demo.gif" alt="mockd demo" width="800">
  24. </p>
  25. ---
  26. ## Quick Start
  27. ```bash
  28. # Install
  29. curl -sSL https://get.mockd.io | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 37 on GitHub
  30. # Start + create a stateful CRUD API in one command
  31. mockd start
  32. mockd add http --path /api/users --stateful users
  33. # It works immediately
  34. curl -X POST localhost:4280/api/users -d '{"name":"Alice","email":"alice@test.com"}'
  35. # → {"id":"a1b2c3","name":"Alice","email":"alice@test.com"}
  36. curl localhost:4280/api/users
  37. # → {"data":[{"id":"a1b2c3","name":"Alice","email":"alice@test.com"}],"meta":{"total":1}}
  38. ```
  39. <details>
  40. <summary><strong>More install options</strong></summary>
  41. ```bash
  42. brew install getmockd/tap/mockd # Homebrew
  43. docker run -p 4280:4280 -p 4290:4290 ghcr.io/getmockd/mockd:latest # Docker
  44. go install github.com/getmockd/mockd/cmd/mockd@latest # Go
  45. ```
  46. Pre-built binaries for Linux, macOS, and Windows on the [Releases](https://github.com/getmockd/mockd/releases) page.
  47. </details>
  48. ## Why mockd?
  49. Every other mock tool makes you choose: pick one protocol, install a runtime, bolt on extensions. mockd doesn't.
  50. | | mockd | WireMock | Mockoon | Prism | MockServer | Beeceptor | json-server |
  51. |---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
  52. | **Single binary, no runtime** | ✅ | ❌ JVM | ❌ Electron | ✅ | ❌ JVM | ❌ SaaS | ❌ Node |
  53. | **All 9 protocols built-in** | ✅ | 🔌 Ext | Partial | HTTP only | HTTP only | Partial | REST only |
  54. | **Chaos profiles + circuit breakers** | ✅ | ⚠️ Cloud | ❌ | ❌ | ❌ | ❌ | ❌ |
  55. | **MCP server** | ✅ local | ⚠️ Cloud | ❌ | ❌ | ❌ | ⚠️ Cloud, Team+ | ❌ |
  56. | **Free + self-hostable, unlimited** | ✅ | ✅ | ✅ | ✅ | ✅ | 50 req/day | ✅ |
  57. > 🔌 **Ext** = requires separate extension JAR • ⚠️ **Cloud** = only in paid/hosted tier
  58. <details>
  59. <summary><strong>Full capability matrix</strong> (deployment, protocols, capabilities, imports/exports, pricing)</summary>
  60. ### Deployment
  61. | | mockd | WireMock | Mockoon | Prism | MockServer | Beeceptor | json-server |
  62. |---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
  63. | Native single binary | ✅ Go | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
  64. | Runtime required | none | JVM | Electron/Node | optional Node | JVM | n/a (SaaS) | Node |
  65. | Docker image | ✅ | ✅ | ✅ CLI | ✅ | ✅ | ⚠️ Enterprise | ❌ |
  66. | Managed SaaS offering | roadmap | WireMock Cloud | Mockoon Cloud | Stoplight | ❌ | ✅ | ❌ |
  67. ### Protocol support
  68. | | mockd | WireMock OSS | Mockoon | Prism | MockServer | Beeceptor | json-server |
  69. |---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
  70. | REST / HTTP | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
  71. | gRPC | ✅ | 🔌 Ext | ❌ | ❌ | ❌ | ✅ | ❌ |
  72. | GraphQL | ✅ | 🔌 Ext | ❌ | ❌ | ❌ | ✅ | ❌ |
  73. | WebSocket | ✅ | 🔌 Ext (beta) | ✅ | ❌ | ❌ | ❌ | ❌ |
  74. | MQTT | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
  75. | SSE | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
  76. | SOAP (WSDL) | ✅ | ❌ | Partial | ❌ | Partial | ✅ | ❌ |
  77. | mTLS | ✅ | ✅ | Partial | ❌ | ✅ | ✅ | ❌ |
  78. | OAuth flows | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
  79. ### Capabilities
  80. | | mockd | WireMock OSS | Mockoon | Prism | MockServer | Beeceptor | json-server |
  81. |---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
  82. | Stateful CRUD | ✅ | ❌ | ✅ | Partial | ❌ | ✅ | ✅ |
  83. | Multi-step stateful flows | ✅ | ✅ Scenarios | Partial | ❌ | Partial | ✅ | ❌ |
  84. | Fault injection (delay, errors) | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ |
  85. | Chaos profiles | ✅ | ⚠️ Cloud | ❌ | ❌ | ❌ | ❌ | ❌ |
  86. | Circuit breakers | ✅ | ⚠️ Cloud | ❌ | ❌ | ❌ | ❌ | ❌ |
  87. | Bandwidth throttling | ✅ | ❌ | ❌ | ❌ | ❌ | roadmap | ❌ |
  88. | Admin REST API | ✅ | ✅ | CLI only | ❌ | ✅ | ✅ | Partial |
  89. | Built-in web dashboard | ✅ | ⚠️ Cloud | ⚠️ Cloud | ❌ | ✅ read-only | ✅ | ❌ |
  90. | Native desktop GUI | ❌ | ❌ | ✅ Electron | ❌ | ❌ | ❌ | ❌ |
  91. | MCP server | ✅ local | ⚠️ Cloud | ❌ | ❌ | ❌ | ⚠️ Cloud Team+ | ❌ |
  92. | Cloud tunnel sharing | ✅ | ❌ | ⚠️ Cloud | ❌ | ❌ | ✅ | ❌ |
  93. ### Import / export
  94. | | mockd | WireMock OSS | Mockoon | Prism | MockServer | Beeceptor | json-server |
  95. |---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
  96. | OpenAPI import | ✅ | ⚠️ Cloud | ✅ | ✅ | ✅ | ✅ | ❌ |
  97. | Postman import | ✅ | ⚠️ Cloud | ❌ | ✅ | ❌ | ❌ | ❌ |
  98. | HAR import | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
  99. | WSDL import | ✅ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
  100. | cURL import | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
  101. | WireMock format import | ✅ | native | ❌ | ❌ | ❌ | ❌ | ❌ |
  102. | Mockoon format import | ✅ | ❌ | native | ❌ | ❌ | ❌ | ❌ |
  103. | HAR export | ✅ | ✅ | ❌ | ❌ | ✅ | ✅ | ❌ |
  104. ### Free tier limits
  105. | | Requests | Mock rules | Cost |
  106. |---|---|---|---|
  107. | mockd | unlimited | unlimited | free (Apache 2.0) |
  108. | WireMock OSS | unlimited | unlimited | free (Apache 2.0) |
  109. | Mockoon desktop / CLI | unlimited | unlimited | free (MIT) |
  110. | Prism | unlimited | unlimited | free (Apache 2.0) |
  111. | MockServer | unlimited | unlimited | free (Apache 2.0) |
  112. | Beeceptor free tier | 50 / day / endpoint | 3 | $10/mo+ for more |
  113. | json-server | unlimited | unlimited | free (MIT) |
  114. **Legend**: ✅ built-in • 🔌 Ext = separate OSS extension • ⚠️ Cloud = only in paid / hosted tier • Partial = limited implementation • roadmap = on the project's stated roadmap, not yet shipped
  115. > **Note on WireMock imports.** The `⚠️ Cloud` marks on OpenAPI and Postman import reflect first-party WireMock features. Community converters exist (e.g. `openapi-to-wiremock`, OpenAPI Generator targets) but are not bundled with the OSS standalone JAR.
  116. </details>
  117. ## Digital Twins
  118. Import a real API spec, bind it to stateful tables, and get a mock that passes the real SDK:
  119. ```yaml
  120. # mockd.yaml — Stripe digital twin
  121. version: "1.0"
  122. imports:
  123. - path: stripe-openapi.yaml
  124. as: stripe
  125. tables:
  126. - name: customers
  127. idStrategy: prefix
  128. idPrefix: "cus_"
  129. seedData:
  130. - { id: "cus_1", name: "Acme Corp", email: "billing@acme.com" }
  131. extend:
  132. - { mock: stripe.GetCustomers, table: customers, action: list }
  133. - { mock: stripe.PostCustomers, table: customers, action: create }
  134. - { mock: stripe.GetCustomersCustomer, table: customers, action: get }
  135. - { mock: stripe.PostCustomersCustomer, table: customers, action: update }
  136. - { mock: stripe.DeleteCustomersCustomer, table: customers, action: delete }
  137. ```
  138. ```bash
  139. mockd start -c mockd.yaml --no-auth
  140. curl -X POST localhost:4280/v1/customers -d "name=Test&email=test@corp.com"
  141. # → {"id":"cus_a1b2c3","object":"customer","name":"Test","email":"test@corp.com"}
  142. ```
  143. **Validated with real SDKs:**
  144. - Stripe: **49/49** `stripe-go` SDK tests pass
  145. - Twilio: **13/13** `twilio-go` SDK tests pass
  146. - OpenAI: `openai` Python SDK verified (models, assistants, chat completions)
  147. See [mockd-samples](https://github.com/getmockd/mockd-samples) for complete digital twin configs.
  148. ## AI-Native (MCP)
  149. mockd includes a built-in [Model Context Protocol](https://modelcontextprotocol.io/) server with **18 tools**. AI agents can create mocks, manage state, import specs, and verify contracts without touching the CLI:
  150. ```json
  151. {
  152. "mcpServers": {
  153. "mockd": { "command": "mockd", "args": ["mcp"] }
  154. }
  155. }
  156. ```
  157. Works in Claude Desktop, Cursor, Windsurf, and any MCP-compatible editor. Tools cover mock CRUD, stateful resources, chaos injection, request logs, verification, workspaces, and import/export.
  158. ## Features
  159. <details>
  160. <summary><strong>Multi-Protocol Mocking</strong> — 7 protocols, unified CLI</summary>
  161. | Protocol | Port | Example |
  162. |----------|------|---------|
  163. | HTTP/HTTPS | 4280 | `mockd add http --path /api/hello --body '{"msg":"hi"}'` |
  164. | gRPC | 50051 | `mockd add grpc --proto svc.proto --service Greeter --rpc-method Greet` |
  165. | GraphQL | 4280 | `mockd add graphql --path /graphql --operation hello` |
  166. | WebSocket | 4280 | `mockd add websocket --path /ws --echo` |
  167. | MQTT | 1883 | `mockd add mqtt --topic sensors/temp --payload '{"temp":72}'` |
  168. | SSE | 4280 | `mockd add http --path /events --sse --sse-event 'data: hello'` |
  169. | SOAP | 4280 | `mockd add soap --path /soap --operation GetWeather --response '<OK/>'` |
  170. </details>
  171. <details>
  172. <summary><strong>Import & Export</strong> — OpenAPI, Postman, HAR, WireMock, cURL, WSDL</summary>
  173. ```bash
  174. mockd import openapi.yaml # OpenAPI 3.x / Swagger 2.0
  175. mockd import collection.json # Postman collections
  176. mockd import recording.har # HAR files
  177. mockd import wiremock-mapping.json # WireMock stubs
  178. mockd import service.wsdl # WSDL → SOAP mocks
  179. mockd import "curl -X GET https://api.example.com/users" # cURL commands
  180. mockd export --format yaml > mocks.yaml
  181. ```
  182. </details>
  183. <details>
  184. <summary><strong>Chaos Engineering</strong> — latency, errors, circuit breakers</summary>
  185. ```bash
  186. mockd chaos apply flaky # 30% error rate
  187. mockd chaos apply slow-api # 200-800ms latency
  188. mockd chaos apply offline # 100% 503 errors
  189. mockd chaos disable
  190. ```
  191. </details>
  192. <details>
  193. <summary><strong>Cloud Tunnel</strong> — share local mocks instantly</summary>
  194. ```bash
  195. mockd tunnel
  196. # → https://a1b2c3d4.tunnel.mockd.io → http://localhost:4280
  197. ```
  198. All 7 protocols multiplexed through a single secure connection on port 443. Works behind NAT and firewalls.
  199. </details>
  200. <details>
  201. <summary><strong>Workspaces</strong> — isolated mock environments</summary>
  202. ```bash
  203. mockd workspace create -n "Payment API" --use
  204. mockd import stripe-openapi.yaml
  205. mockd workspace create -n "Comms API" --use
  206. mockd import twilio-openapi.yaml
  207. # Mocks, state, and logs are fully isolated per workspace
  208. ```
  209. </details>
  210. <details>
  211. <summary><strong>Proxy Recording</strong> — record real traffic, replay as mocks</summary>
  212. ```bash
  213. mockd proxy start --port 8888
  214. # Configure your app to use http://localhost:8888 as proxy
  215. # Traffic is recorded, then replay with:
  216. mockd import recordings/session.json
  217. ```
  218. </details>
  219. <details>
  220. <summary><strong>Web Dashboard</strong> — manage mocks visually</summary>
  221. Release builds serve a web UI from the admin port (`http://localhost:4290`). VS Code-style editor, command palette, mock tree with folders, request log viewer, and near-miss debugging.
  222. </details>
  223. ## Mockd Cloud
  224. mockd works fully offline with no account required. For teams that want shared environments:
  225. - **Persistent cloud mocks** — deploy mock environments your whole team can hit
  226. - **Team management** — shared workspaces with access controls
  227. - **Cloud tunnels** — authenticated tunnels with custom domains
  228. Coming soon. [Join the waitlist](https://mockd.io/pricing#waitlist-form).
  229. ## Documentation
  230. Full guides, API reference, and config docs at **[docs.mockd.io](https://docs.mockd.io)**.
  231. ## Contributing
  232. Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for setup.
  233. ## License
  234. [Apache License 2.0](LICENSE) — free for commercial use.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.