{"id":"dev.workers.mockbird.mockbird/mockbird","slug":"dev-workers-mockbird-mockbird-mockbird","title":"Mockbird","description":"Mock REST APIs, fake OAuth2/OIDC provider, uptime monitors + heartbeats, live badge/QR images.","version":"1.6.0","publisher":{"kind":"domain","id":"mockbird.mockbird.workers.dev","label":"mockbird.mockbird.workers.dev","url":"https://mockbird.mockbird.workers.dev"},"website":"https://mockbird.mockbird.workers.dev","repository":"","remotes":[{"type":"streamable-http","url":"https://mockbird.mockbird.workers.dev/mcp"}],"packages":[],"published":"2026-09-17","updated":"2026-09-17","status":"online","auth":"","latency_ms":1222,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"create_project","title":"","description":"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/reviews), saas (users/teams/events), payments (Stripe-shaped sandbox: charges/refunds/subscriptions/c","read_only":false},{"name":"import_data","title":"","description":"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 db.json → hosts your exact records; Postman Collection v2.x → resources from requests, saved example","read_only":false},{"name":"fork_project","title":"","description":"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 the agent mutate the fork freely, then grade with snapshots action:\"diff\". withSnapshots:true also c","read_only":false},{"name":"add_resource","title":"","description":"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|email|avatar|image|word|words|title|sentence|paragraph|number|price|percent|boolean|date|pastDate|future","read_only":false},{"name":"project_info","title":"","description":"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.","read_only":false},{"name":"query_records","title":"","description":"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=<parent>/_embed=<children> relations. Failure simulation for testing: mock_status=503 forces that status,","read_only":false},{"name":"write_record","title":"","description":"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.","read_only":false},{"name":"generate_fake_data","title":"","description":"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/ISBN13 checksums are real; image URLs are live SVG placeholders served by Mockbird). Or pass fields for a","read_only":false},{"name":"custom_route","title":"","description":"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 take precedence over resource routes; '*' catch-alls are a fallback. Max 20 routes/project.","read_only":false},{"name":"inspect_requests","title":"","description":"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 code at the mock, run it, then inspect. Pairs with custom_route catch-all bins (e.g. /webhooks/*) fo","read_only":false},{"name":"share_project","title":"","description":"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 your human the shareUrl to review your work — no key handover. Works even when the project is in prote","read_only":false},{"name":"delete_project","title":"","description":"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.","read_only":false},{"name":"snapshots","title":"","description":"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 against) and returns {identical, summary, resources[] with per-record added/removed/changed field d","read_only":false},{"name":"verdict","title":"","description":"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:\"save\" with data), and/or trajectory constraints like [{method:\"DELETE\", count:0}, {method:\"POST\", pa","read_only":false},{"name":"check_api_status","title":"","description":"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 envelopes is probed by body and honestly reported as failing). No arguments → compact summary: up/do","read_only":false},{"name":"uptime_monitor","title":"","description":"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); with notify, that webhook gets ONE message when it goes down and ONE when it recovers — debounced (two ","read_only":false},{"name":"heartbeat","title":"","description":"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?}: period_minutes = how often the job runs (30–10080); grace defaults to half the period. With notify, mis","read_only":false},{"name":"watch_service_status","title":"","description":"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 webhook gets one message when the service goes down and one when it recovers (debounced across two cons","read_only":false},{"name":"image_url","title":"","description":"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 validated against the real endpoint before the URL is returned, so a returned URL is guaranteed to r","read_only":false}],"server_info":{"name":"mockbird","title":"Mockbird — instant mock REST APIs","version":"1.6.0"},"category":"project","tags":["cloud","image-video","data"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-17","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/dev-workers-mockbird-mockbird-mockbird/"}