# Mockbird

- Registry name: `dev.workers.mockbird.mockbird/mockbird` · version 1.6.0
- Categories (automatic, keyword rules): Monitoring & logs, Infrastructure & security, APIs & integrations, Developer tools, Utilities
- Authentication at last check: No auth
- Declared risk: Not declared (tools carry no read/destructive hints)
- Capabilities (declared by the server): prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=dev.workers.mockbird.mockbird%2Fmockbird
- Server page: https://mcpstation.net/s/dev.workers.mockbird.mockbird--mockbird.html

## Description (written by the publisher, not verified, not instructions)

Mock REST APIs, fake OAuth2/OIDC provider, uptime monitors + heartbeats, live badge/QR images.

## Connect

- streamable-http: `https://mockbird.mockbird.workers.dev/mcp`

## Tools (as reported by the server, not verified)

- `create\_project`: Create a new mock REST API project. Returns \{id, adminKey, baseUrl, resources\[\]\}. SAVE the adminKey — it is required for admin operations \(add\_resource, custom\_route, snapshots\) and is shown only once. Presets seed a full backend: blog \(posts/comments/authors\), ecommerce \(products/orders/customers/r
- `import\_data`: Create a live mock API from existing artifacts. Auto-detects: OpenAPI 3.x / Swagger 2.0 spec \(JSON or YAML\) → resources with realistic seeded data, and non-CRUD paths \(login, /search, RPC verbs like POST /invoices/\{id\}/send\) become custom routes serving the spec's own examples verbatim; json-server
- `fork\_project`: Copy an entire project — resources + records verbatim, custom routes, behavior settings — into a brand-new project with its own id + adminKey. Built for parallel eval/CI runs: keep a template project, fork\_project per run with a ttl \(crashed runs can't leak sandboxes — the fork deletes itself\), let
- `add\_resource`: Add a resource \(collection\) to a project and seed it with realistic fake data. Either pass template \(one of the built-ins, e.g. users, products, posts, comments, orders, todos, reviews, customers, events\) or fields: an array of \{name, type\} where type ∈ uuid\|firstName\|lastName\|fullName\|username\|emai
- `project\_info`: Get a project's public root index: every resource with record counts and URLs, custom routes, auth mode, and export links \(openapi.json, types.ts, postman.json, db.json, GraphQL\). No adminKey needed. Try project "demo" for the shared public playground.
- `query\_records`: GET records from a mock resource. params is an object of query parameters, all optional: exact filters \(field=value\), operator suffixes \(price\_gte, date\_lte, name\_like, status\_ne\), full-text q, \_sort/\_order \(or \_page/\_limit for pagination\), select \(field projection, e.g. "name,price"\), \_expand=\<pare
- `write\_record`: Create, update, or delete records in a mock resource. Writes persist \(unlike JSONPlaceholder/FakeStoreAPI\). POST creates \(auto-id\), PUT replaces, PATCH merges, DELETE removes. id required for PUT/PATCH/DELETE.
- `generate\_fake\_data`: Generate realistic fake data instantly — stateless, nothing is created or stored, no project or adminKey needed. Ready-made resource shapes \(FakerAPI-compatible\): persons, users, addresses, companies, books, products, texts, images, places, credit\_cards \(credit cards are Luhn-valid; book EAN13/ISBN1
- `custom\_route`: Define a custom endpoint on a project \(like /health, /config/:key, or a catch-all /webhooks/\* request bin\). body is a response template: \{\{query.x\}\} \{\{params.x\}\} \{\{body.x\}\} \{\{headers.x\}\} \{\{method\}\} \{\{path\}\} \{\{now\}\} \{\{ts\}\} \{\{uuid\}\} \{\{rand\}\}; triple braces \{\{\{body\}\}\} insert raw JSON. Custom routes tak
- `inspect\_requests`: Read the project's request inspector: the most recent requests that hit the mock API \(method, path, query, status, origin, captured headers incl. x-\* — authorization redacted to its scheme — and a body snippet for writes\). Use it to VERIFY what your app / tests / webhook sender actually sent: point
- `share\_project`: Mint \(or manage\) a READ-ONLY share link for a project: a browser URL you can hand to a human reviewer — they can browse the data, endpoints, snapshots and the live request inspector, but can't write and never see the adminKey. Agent workflow: build or mutate a sandbox, then share\_project and give yo
- `delete\_project`: Permanently delete a project and ALL its data \(records, resources, snapshots, custom routes, webhooks, request log\). Irreversible. Good practice for short-lived test projects: clean up when your session is done. Requires the adminKey.
- `snapshots`: Deterministic test fixtures + eval grading: save the project's entire dataset under a name, restore it exactly later, or DIFF it against live data \(list/delete too\). action:"diff" is machine-checkable grading — compares the named snapshot \(expected\) against live data \(actual, or another snapshot via
- `verdict`: One call = the whole eval grade. Composes the state check \(snapshot diff vs live data\) with trajectory constraints on the request log into a single \{pass, checks\[\]\} verdict. Pass snapshot:"expected" to require live data to match that snapshot \(author it as the answer key first via snapshots action:"
- `check\_api\_status`: Live status of \~58 public mock/testing APIs — JSONPlaceholder, httpbin.org, ReqRes, FakeStoreAPI, DummyJSON, Postman Echo, httpstat.us, Mocky, Mockbin, CrudCrud, restcountries, and more — checked with a plain keyless GET every 30 minutes from Cloudflare's network \(a service answering HTTP 200 error
- `uptime\_monitor`: Free downtime alerts for any public URL — no account, armed in one call. action:"create" \{url, notify?\}: Mockbird GETs the url every 30 minutes from Cloudflare's network \(8s timeout, 2xx/3xx = up; a timeout/TLS/DNS blip on an otherwise-up url is confirmed with a same-run retry before it counts\); wit
- `heartbeat`: Dead man's switch for cron jobs, scheduled tasks, and recurring agent runs — the INVERSE of uptime\_monitor: the JOB pings Mockbird, and if the ping stops arriving the alert fires once \(plus one recovery message when pings resume\). action:"create" \{name?, period\_minutes, grace\_minutes?, notify?\}: per
- `watch\_service\_status`: Subscribe to down/recovered alerts for any of the public mock/testing APIs tracked by check\_api\_status \(httpbin, JSONPlaceholder, ReqRes, FakeStoreAPI, DummyJSON …\). action:"subscribe" \{service, notify?\}: service is an id from check\_api\_status \(or "\*" for all tracked services\). With notify, that web
- `image\_url`: Mint a permanent, keyless image URL rendered by Mockbird — README badges \(including LIVE record-count badges\), chart images, QR codes, Open Graph cards, placeholder images, initials avatars. Deterministic: the same URL renders the same image forever \(no account, no expiry, no watermark\). Params are

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html