Mockzilla Mcp
Lets Claude or Cursor spin up local mock servers from any OpenAPI spec without leaving your editor. You can mock Stripe, PayPal, Binance, or OpenAI endpoints locally to avoid burning test credits or hitting rate limits during development. The local plane needs no account and runs entirely on your machine: install the CLI, inspect specs, serve mocks, stop servers. Add a MOCKZILLA_TOKEN and you get hosted tools to deploy persistent mocks at mockzilla.org, browse their catalog, and list your running sims. Useful for CI pipelines, agentic workflows where Claude manages the mock lifecycle, or prototyping against third-party APIs before you have sandbox credentials.
- GitHub stars
- 5
- tools
- 29
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Oct 9, 2026
Tools
29 toolsPublic tool metadata for what this MCP can expose to an agent.
check_cliResolve Mockzilla on this machine: system PATH -> bridge cache -> go run invocation. Returns install options if nothing matches.
Resolve Mockzilla on this machine: system PATH -> bridge cache -> go run invocation. Returns install options if nothing matches.
No parameter schema in public metadata yet.
install_cliInstall Mockzilla into ~/.cache/mockzilla-mcp/. Methods: download (prebuilt from GitHub releases, default), go-install, go-run. Never touches system PATH.
Install Mockzilla into ~/.cache/mockzilla-mcp/. Methods: download (prebuilt from GitHub releases, default), go-install, go-run. Never touches system PATH.
No parameter schema in public metadata yet.
bridge_statusReport the bridge's version, check npm for newer publishes, and surface upgrade steps.
Report the bridge's version, check npm for newer publishes, and surface upgrade steps.
No parameter schema in public metadata yet.
infoSummarise an OpenAPI spec without serving it: title, version, openapi_version, endpoint_count, paths. Also reads .mockz packages.
Summarise an OpenAPI spec without serving it: title, version, openapi_version, endpoint_count, paths. Also reads .mockz packages.
No parameter schema in public metadata yet.
lintFind schemas in a spec that no value can satisfy, so a broken spec is caught before serving it.
Find schemas in a spec that no value can satisfy, so a broken spec is caught before serving it.
No parameter schema in public metadata yet.
discover_specsScan a directory for OpenAPI specs and folders of static endpoint files. Returns a suggested_input for serve_locally.
Scan a directory for OpenAPI specs and folders of static endpoint files. Returns a suggested_input for serve_locally.
No parameter schema in public metadata yet.
mockzilla_docs_topicsList the Mockzilla docs, by category, with each topic's title and summary.
List the Mockzilla docs, by category, with each topic's title and summary.
No parameter schema in public metadata yet.
mockzilla_docs_readReturn the full markdown for one or more topics, or a whole category.
Return the full markdown for one or more topics, or a whole category.
No parameter schema in public metadata yet.
mockzilla_docs_searchKeyword search across all docs; returns top sections with snippets.
Keyword search across all docs; returns top sections with snippets.
No parameter schema in public metadata yet.
simplifyDrop or reduce union types, strip x-* extensions, and optionally cap optional properties per schema. Writes the simplified spec to disk and returns its path.
Drop or reduce union types, strip x-* extensions, and optionally cap optional properties per schema. Writes the simplified spec to disk and returns its path.
No parameter schema in public metadata yet.
packPack a directory of services into a .mockz archive that serve_locally can serve, even from a URL.
Pack a directory of services into a .mockz archive that serve_locally can serve, even from a URL.
No parameter schema in public metadata yet.
generateRun mockzilla generate to produce Go models, a server, a client or MCP tools from a spec. Writes files, lists them with dry_run, or reports stale ones with check.
Run mockzilla generate to produce Go models, a server, a client or MCP tools from a spec. Writes files, lists them with dry_run, or reports stale ones with check.
No parameter schema in public metadata yet.
serve_locallyStart a portable mock server on a free port. Accepts a spec file, directory, or public https URL. Returns url, port, pid, services.
Start a portable mock server on a free port. Accepts a spec file, directory, or public https URL. Returns url, port, pid, services.
No parameter schema in public metadata yet.
stop_locallyStop a server started by serve_locally.
Stop a server started by serve_locally.
No parameter schema in public metadata yet.
call_endpointMake an HTTP request and return status, headers, body, to show a mock's response. Localhost only unless allow_remote is set.
Make an HTTP request and return status, headers, body, to show a mock's response. Localhost only unless allow_remote is set.
No parameter schema in public metadata yet.
mock_endpointQuickly mock a single HTTP endpoint without an OpenAPI spec. Writes a static response into the managed mocks dir and (re)starts the shared server.
Quickly mock a single HTTP endpoint without an OpenAPI spec. Writes a static response into the managed mocks dir and (re)starts the shared server.
No parameter schema in public metadata yet.
list_mock_endpointsList all endpoints currently mocked, plus the running server's URL and the Mockzilla UI URL.
List all endpoints currently mocked, plus the running server's URL and the Mockzilla UI URL.
No parameter schema in public metadata yet.
clear_mock_endpointsWipe all mocks and stop the managed server.
Wipe all mocks and stop the managed server.
No parameter schema in public metadata yet.
request_historyList the requests the running server answered: method, URL, status, content type, latency, and origin. Pass id with service for one request's full headers and body.
List the requests the running server answered: method, URL, status, content type, latency, and origin. Pass id with service for one request's full headers and body.
No parameter schema in public metadata yet.
diagnose_requestsExplain what is wrong with the recorded traffic and where its data came from, with latency percentiles and findings about upstream failures, wrong mount prefixes and content type mismatches.
Explain what is wrong with the recorded traffic and where its data came from, with latency percentiles and findings about upstream failures, wrong mount prefixes and content type mismatches.
No parameter schema in public metadata yet.
setup_replayConfigure replay for a service: record a response once, then serve it back for every matching request.
Configure replay for a service: record a response once, then serve it back for every matching request.
No parameter schema in public metadata yet.
list_replaysList a service's recordings, with the request values each one is keyed by.
List a service's recordings, with the request values each one is keyed by.
No parameter schema in public metadata yet.
check_github_deployableSay whether a repository or folder would deploy a mock, and what is missing if not. Read-only.
Say whether a repository or folder would deploy a mock, and what is missing if not. Read-only.
No parameter schema in public metadata yet.
list_github_reposThe user's repositories, flagging which already publish mocks.
The user's repositories, flagging which already publish mocks.
No parameter schema in public metadata yet.
publish_to_githubPush mocks to one of the user's own repositories and let the Mockzilla action deploy them at a host of their own.
Push mocks to one of the user's own repositories and let the Mockzilla action deploy them at a host of their own.
No parameter schema in public metadata yet.
wait_for_github_deployWait for the workflow run and return the live URL, as the action reported it.
Wait for the workflow run and return the live URL, as the action reported it.
No parameter schema in public metadata yet.
unpublish_from_githubTake the mocks down and free the simulation slot, optionally deleting the repository too.
Take the mocks down and free the simulation slot, optionally deleting the repository too.
No parameter schema in public metadata yet.
loginOpens the Mockzilla login in the browser and saves the login under ~/.config/mockzilla-mcp/.
Opens the Mockzilla login in the browser and saves the login under ~/.config/mockzilla-mcp/.
No parameter schema in public metadata yet.
logoutRevokes the connection and deletes the saved login.
Revokes the connection and deletes the saved login.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MOCKZILLA_TOKENsecretAPI 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.
Readme
@mockzilla/mcp
MCP server for Mockzilla - an open-source API mock server for OpenAPI specifications. Let Claude Code, Claude Desktop, Cursor, or Gemini CLI install Mockzilla, inspect OpenAPI specs, and spin up realistic local mock APIs in seconds. No account required for local use.
Source: github.com/mockzilla/mockzilla-mcp
Use cases
- Local API development - mock any OpenAPI spec without a real backend or sandbox account
- CI/CD integration testing - zero external dependencies in your pipeline
- PSP and payment API mocking - Stripe, PayPal, Adyen from your editor without test accounts
- Crypto exchange API mocking - Binance, Bybit without registered accounts
- Rate limit protection - develop against OpenAI, Twilio without burning quota
- Agentic workflows - let Claude or Cursor spin up and manage mock servers automatically
Two planes
@mockzilla/mcp exposes two planes of tools to your MCP client.
Local plane (no account required)
Runs on your machine. No Mockzilla account needed.
From an agent you can:
Details
- Repository
- github.com/mockzilla/mockzilla-mcp
- Website
- mockzilla.org
- Category
- Monitoring & Observability
- Package
@mockzilla/mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Monitoring & Observability MCP servers
View all
Mcp Servercoinversaa/mcp-serverCrypto intelligence for AI agents. Hyperliquid trader analytics, cohorts, and live market data.0stars
Devops Mcpnotharshhaa/devops-mcpUnified MCP server for Kubernetes, ArgoCD, Prometheus, PagerDuty, and Loki4stars
Runframe Mcp Serverrunframe/runframe-mcp-serverMCP server for Runframe incident management covering incidents, on-call, postmortems, and more.4stars
Portkey Admin Mcps-b-e-n-s-o-n/portkey-admin-mcpFull Portkey Admin API MCP server — configs, prompts, keys, analytics, and more.4stars
Easy Digital Downloadsverygoodplugins/mcp-eddMCP server for Easy Digital Downloads REST API - sales, customers, products, analytics4stars
Cronometer MCPatticoos/cronometer-mcpReview nutrition, log meals, and manage foods and recipes in your Cronometer account.3stars