Whip up a
mock API.
A complete mock server, dashboard, and database in one ~25 MB binary. Mix one up locally in seconds — or self-host it on your own infrastructure.
A dashboard that comes in the box.
Freshly mixed, every request.
Model the responses your app expects — headers, delays, even the flaky 401 — and let Mocktail keep the data lively.
Edit, validate, randomize
Write and validate JSON right in Mocktail. Keep responses fixed, generate fresh values on every request (uuid, email, price, name), or swap real fields for fake data when you need to anonymize a response.
{
"id": "3f9a8c1e" ⟳ uuid
"name": "Ada Lovelace" ⟳ fullName
"email": "[email protected]" ⟳ email
}Watch every request land
Create an endpoint, hit Test right from the dashboard, and watch it land in the live stream — method, status, latency, and the exact response and headers served. Filter by path or status. The whole loop, without leaving the app.
Model the messy parts
Real APIs aren't always a happy 200. Return a 429 with Retry-After, add 800 ms of latency, serve a problem+json error — whatever your app has to handle.
HTTP/1.1 429 Too Many Requests Retry-After: 30 Content-Type: application/problem+json X-RateLimit: 0/100
Describe it, don't type it
Bring your own key. Say what you want in plain language and Mocktail drafts the whole response with Claude, right in the dashboard. Your key never leaves your machine; chats are never stored.
{
"id": "ord_8a2f",
"items": 3,
"total": "$84.20"
}
Or let your AI tools drive
The built-in MCP server plugs Mocktail into Claude Desktop & Code. Ask, and they create and edit mocks for you — a sentence becomes a live endpoint, no dashboard required.
When to pour one.
One tool across the whole lifecycle — from your first frontend commit to demo day.
No backend yet
Keep building the frontend while the real API catches up.
Test the ugly stuff
Slow responses, 401 · 429 · 500, rate limits, edge cases — without breaking anything real.
Demo day can’t go down
A stable, self-contained API for demos, prototypes, workshops, or QA.
Your first pour.
The dashboard comes with it — on macOS, Linux, and Windows. Open localhost:6625 and start mocking.
brew install --cask Huseyinnurbaki/tap/mocktail
mocktail
# → opens http://localhost:6625Questions, answered.
What is Mocktail?
Mocktail is a self-hosted mock API server with a built-in dashboard, shipped as a single binary. Define endpoints and responses, then call them from your app like a real API. Run it locally or deploy it to your own infrastructure.
Is Mocktail free and open source?
Yes. Mocktail is free and open source on GitHub. There's no sign-up or paid tier required — run it on your laptop or your own servers.
How do I install Mocktail?
Install it with Homebrew (brew install --cask Huseyinnurbaki/tap/mocktail), run it with Docker, or download the binary directly. Local installs open the dashboard at localhost:6625 by default. A native desktop app is coming soon.
Where does my data live?
Wherever you run Mocktail. Data is stored in a single SQLite file on your machine or a mounted volume when using Docker. Nothing is sent to Mocktail, and there's no telemetry. Mocks can also be exported as JSON to commit or share.
Can Mocktail generate realistic test data?
Yes, optionally. Serve a fixed response as-is, or attach generators to individual fields like UUIDs, emails, prices, and names for fresh values on every request. You can also replace fields in existing responses with generated data.
Does Mocktail work with AI tools?
Yes. The built-in AI assistant can draft responses from plain-language prompts using your own API key, while the MCP server lets tools like Claude Desktop and Claude Code create and manage mocks directly.
Can my team share a Mocktail instance?
Yes. Deploy the Docker image to infrastructure your team can access and use the same Mocktail instance across development, testing, and demos.
