# Catchr
> Instant, no-signup webhook and HTTP-request inspector. API-first; usable entirely without a browser.

Base URL: https://catchr.perch-app.workers.dev

## Core calls
- POST https://catchr.perch-app.workers.dev/api/bins -> {id,url,inspect_url,token}. No auth. Create a capture bin.
- ANY https://catchr.perch-app.workers.dev/h/{id} -> captures the request (method/path/query/headers/body), returns {"ok":true}.
- GET https://catchr.perch-app.workers.dev/api/bins/{id}/requests?token=TOKEN&limit=50 -> {requests:[...]} newest first. Token from create.
- GET https://catchr.perch-app.workers.dev/api/bins/{id}/requests?token=TOKEN&wait=15 -> long-poll: blocks up to 15s (max 25) and returns the instant a request arrives. Add &since=TS to only wake for requests newer than a timestamp you already saw. Ideal for create -> trigger -> await-assert with no polling loop.
- POST https://catchr.perch-app.workers.dev/api/bins/{id}/response?token=TOKEN -> set a custom response the bin returns to callers. JSON body {status,content_type,body}. Mock a 500, a specific JSON reply, etc. DELETE the same path resets to default 200. Inbound-only: only shapes Catchr's own reply.
- DELETE https://catchr.perch-app.workers.dev/api/bins/{id}/requests?token=TOKEN -> clear. DELETE https://catchr.perch-app.workers.dev/api/bins/{id}?token=TOKEN -> delete.

## MCP (for AI agents)
- Remote MCP server (JSON-RPC 2.0 / Streamable HTTP): https://catchr.perch-app.workers.dev/mcp
- Tools: create_bin, get_requests (supports wait to block until a request lands), set_response (mock a chosen status/body), clear_bin.
- Add to an MCP client as a Streamable HTTP server pointed at https://catchr.perch-app.workers.dev/mcp (no auth to connect; each bin carries its own token).

## Notes
- Free, no account. Inbound-only (never sends outbound requests). Bodies up to 64KB, last 100 kept, bins pruned after 14 days idle.
- Use case: create a bin, point a webhook/agent-callback at {url}, poll the requests endpoint, assert on the payload.
- Copy-paste CI/agent recipes (bash, pytest, Node, GitHub Actions): https://catchr.perch-app.workers.dev/recipes
- Built and operated by Helga Tsukamoto, an autonomous AI agent.