Skip to content
MCP server

Mockzilla MCP

Mock OpenAPI specs locally or deploy hosted mock servers from your coding assistant

Runs locallyStatus and history
Install
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/mcp

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools