Mockzilla MCP
Mock OpenAPI specs locally or deploy hosted mock servers from your coding assistant
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.2.28
- Listing updated
- 2 days ago
About Mockzilla MCP
Mockzilla MCP is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The server has two planes. The local plane needs no account: it checks whether the Mockzilla CLI is installed and can install it into a managed cache, then inspects and lints specs, simplifies heavy ones, packs services into .mockz archives and generates Go code such as models, a server for one of 14 routers, a client or MCP tools. It can serve a spec as a local mock, mock a single endpoint without a spec, and list, stop or clear managed mocks.
The hosted plane unlocks after a browser login, where you pick an organisation and read-only or read-write access. Agents can then list deployed sims, browse catalogue products, deploy hosted mocks from a spec, URL or catalogue bundle and wait for the live URL. An API key in MOCKZILLA_TOKEN can replace login on machines without a browser.
The mock engine is MIT licensed. Hosted plans on mockzilla.org include a free tier and paid tiers from $10 a month, with per-plan request, throughput and storage limits.
Install
Run in a terminal
claude mcp add mockzilla-mcp --env MOCKZILLA_TOKEN='<MOCKZILLA_TOKEN>' -- npx -y @mockzilla/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mockzilla-mcp": {
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mockzilla-mcp": {
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mockzilla-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mockzilla-mcp": {
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mockzilla-mcp": {
"command": "npx",
"args": [
"-y",
"@mockzilla/mcp"
],
"env": {
"MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
}
}
}
}Configuration
MOCKZILLA_TOKENAPI key (mz_*) to use instead of logging in with the login tool, for machines without a browser. Leave unset to log in from your agent.MOCKZILLA_MCP_URLOverride the hosted MCP endpoint (staging or local development). Defaults to https://platform.mockzilla.org/mcp.MOCKZILLA_MANAGED_PORTPreferred port for the local managed mock server. Defaults to 2200; falls back to a kernel-picked port if busy.
What it does
- Local mock servers
- Serve any OpenAPI spec locally with no account.
- Spec tooling
- Inspect, lint, simplify and pack specs, and generate Go code.
- Hosted deploys
- Deploy mocks from a spec, URL or catalogue bundle after login.
- Per-PR environments
- The platform offers a mock URL per pull request through a GitHub Action.
- Token or browser login
- Use an mz_ API key or log in from the agent.
Good for
- Spin up the Petstore spec locally to curl
- Mock a payment API without test accounts
- Return a 402 from a single mocked endpoint
- Deploy a Stripe mock and share its URL
Pricing
Freemium, from $10 a month
Free tier; paid plans from $10/mo; MIT-licensed local engine
Prices change. Check mockzilla.org before you buy.
Mockzilla MCP FAQ
Do I need an account?
Not for the local plane. Hosted tools need a login or an API key.
What does hosting cost?
The site lists a free tier and plans of $10, $20 and $50 a month.
Is the engine open source?
Yes, the mock server is MIT licensed.
Which clients are covered?
Claude Code, Claude Desktop, Cursor and Gemini CLI.
Is Mockzilla MCP free?
Mockzilla MCP has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.
How do I add Mockzilla MCP to Claude Code?
Run this command in your terminal: claude mcp add mockzilla-mcp --env MOCKZILLA_TOKEN='<MOCKZILLA_TOKEN>' -- npx -y @mockzilla/mcp
What are the best alternatives to Mockzilla MCP?
The closest alternatives to Mockzilla MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Mockzilla MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools