MCP Server

io.github.mockzilla/mockzilla-mcp MCP Server

Name: io.github.mockzilla/mockzilla-mcp MCP Server
Author: io.github.mockzilla

io.github.mockzilla/mockzilla-mcp

Repository Registry

What is the io.github.mockzilla/mockzilla-mcp MCP server?

Mockzilla MCP server. Mock any OpenAPI spec locally with Claude, Cursor, or Gemini CLI.

How to install io.github.mockzilla/mockzilla-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

MOCKZILLA_TOKEN
secret
Bearer token (mz_oauth_* or mz_*) that unlocks the hosted plane on mockzilla.org. Leave unset to use only the local plane.
MOCKZILLA_MCP_URL
Override the hosted MCP endpoint (staging or self-hosted). Defaults to https://platform.mockzilla.org/mcp/.
MOCKZILLA_MANAGED_PORT
Preferred port for the local managed mock server. Defaults to 2200; falls back to a kernel-picked port if busy.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<YOUR_MOCKZILLA_TOKEN>",
        "MOCKZILLA_MCP_URL": "<YOUR_MOCKZILLA_MCP_URL>",
        "MOCKZILLA_MANAGED_PORT": "<YOUR_MOCKZILLA_MANAGED_PORT>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<YOUR_MOCKZILLA_TOKEN>",
        "MOCKZILLA_MCP_URL": "<YOUR_MOCKZILLA_MCP_URL>",
        "MOCKZILLA_MANAGED_PORT": "<YOUR_MOCKZILLA_MANAGED_PORT>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mockzilla-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<YOUR_MOCKZILLA_TOKEN>",
        "MOCKZILLA_MCP_URL": "<YOUR_MOCKZILLA_MCP_URL>",
        "MOCKZILLA_MANAGED_PORT": "<YOUR_MOCKZILLA_MANAGED_PORT>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mockzilla-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mockzilla/mcp"
      ],
      "env": {
        "MOCKZILLA_TOKEN": "<YOUR_MOCKZILLA_TOKEN>",
        "MOCKZILLA_MCP_URL": "<YOUR_MOCKZILLA_MCP_URL>",
        "MOCKZILLA_MANAGED_PORT": "<YOUR_MOCKZILLA_MANAGED_PORT>"
      }
    }
  }
}

Claude Code

claude mcp add mockzilla-mcp --env MOCKZILLA_TOKEN=<YOUR_MOCKZILLA_TOKEN> --env MOCKZILLA_MCP_URL=<YOUR_MOCKZILLA_MCP_URL> --env MOCKZILLA_MANAGED_PORT=<YOUR_MOCKZILLA_MANAGED_PORT> -- npx -y @mockzilla/mcp