# Mockzilla MCP

> Mockzilla MCP is a freemium MCP server for developer tools. Mock OpenAPI specs locally or deploy hosted mock servers from your coding assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** CLI, API
- **Website:** https://mockzilla.org
- **Repository:** https://github.com/mockzilla/mockzilla-mcp
- **MCP Registry name:** io.github.mockzilla/mockzilla-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mockzilla-mcp --env MOCKZILLA_TOKEN='<MOCKZILLA_TOKEN>' -- npx -y @mockzilla/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mockzilla-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<MOCKZILLA_TOKEN>"
      }
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mockzilla-mcp
