# webhooklocal > A webhook debugger for local development. One private HTTPS URL per endpoint that never changes. Every request a provider sends to it is stored (method, path, headers, body) and forwarded to a server on the developer's machine by the `wl` CLI. Any stored request can be replayed, with or without edits. https://webhooklocal.com Full documentation: https://webhooklocal.com/docs ## Setup 1. Sign in at https://webhooklocal.com/signin (GitHub, or an emailed link). The first endpoint, `my-endpoint`, is created on sign-in. 2. Copy the endpoint URL from the dashboard. It looks like https://webhooklocal.com/h/. Paste it into the provider's webhook settings (Stripe: Developers → Webhooks; GitHub: repository Settings → Webhooks, content type application/json). 3. Install the CLI and sign in: curl -fsSL https://webhooklocal.com/install.sh | sh wl login The script verifies the download against https://webhooklocal.com/dl/checksums.txt and installs `webhooklocal` and the alias `wl` into ~/.local/bin without sudo. Binaries for macOS, Linux and Windows (amd64, arm64) are at https://webhooklocal.com/dl/. 4. Forward requests to the local app: wl listen 3000 Each request reaches http://localhost:3000 with the same method, path, headers and body the provider sent. The CLI prints one line per request: time, method, path, event name, the app's status code, duration. Replays are tagged `replay`. ## CLI reference - wl login [--no-browser] sign in on this machine with a code confirmed in the browser - wl logout revoke this machine's token - wl listen [--endpoint name] [--path /prefix] [--host h] [--quiet] - wl endpoints [--json] list endpoints, URLs, and whether a CLI is connected - wl requests [--endpoint name] [--limit n] [--before id] [--q text] [--failed] [--replayed] [--json] list stored requests, newest first - wl request [--reveal] [--body] [--json] one request: headers (masked unless --reveal), body, signature check, replays - wl replay [--to url] [--method M] [--path /p] [--body file|-] [-H 'Name: value']... [--no-resign] [--json] replay, optionally edited; edited bodies are re-signed with the saved secret - HTTP API (Authorization: Bearer ): GET /api/endpoints, GET /api/requests?endpoint=&limit=&before=&q=&failed=1&replayed=1, GET /api/requests/{id}?reveal=1, POST /api/requests/{id}/replay {target:"cli"|"url", url, method, path, headers:{}, body, resign} - wl whoami account, plan, server - wl mcp MCP server over stdio (tools: list_endpoints, list_requests, get_request, replay_request); `wl mcp config` prints the registration snippet. Claude Code: claude mcp add webhooklocal -- wl mcp - wl upgrade [--check] replace this binary with the current build (checksum verified); --check only reports - wl version - Flags/env: --token or WEBHOOKLOCAL_TOKEN; --server or WEBHOOKLOCAL_SERVER (default https://webhooklocal.com). Config: ~/.config/webhooklocal/config.json. Exit status 2 when not signed in, 1 for other errors. ## Dashboard - Request list with search and filters (All, Failed, Replayed); live updates. - Request detail: Body (JSON and XML pretty-printed, form bodies as fields), Headers (Authorization, Cookie and similar masked until revealed), Query, Replays. - Replay to localhost (key R), Edit & replay (key E; headers as rows; JSON, XML and text bodies in a code editor with highlighting and a JSON linter; form bodies as fields or raw), Copy as cURL (key C; a curl command that sends the request to the webhooklocal URL, masked headers left out unless revealed, binary bodies not exact). - Replay to another URL: in the editor, Send to → A URL. The request path is appended to the URL's path. http/https only, on port 80, 443 or 1024+; private, loopback and internal addresses are refused after DNS resolution; redirects are not followed; 30-second timeout; status and the first 64 KB of the body are recorded. - Notices: a toast when a request arrives on another endpoint or a forward fails, linking to the request; optional desktop notifications (Settings → Account), per browser. - Endpoint settings: pause, rotate the URL, choose what the provider receives (pass through the local app's status and body, or always 200), forward path, signing secret. - Signature checks: save the Stripe signing secret (whsec_…) or the GitHub webhook secret in endpoint settings (stored encrypted). Requests with Stripe-Signature or X-Hub-Signature-256 are labelled valid / invalid / not checked; Stripe labels include the timestamp age and a warning past the 5-minute tolerance. Edit & replay re-signs the edited body with the saved secret (fresh timestamp for Stripe) unless unticked. ## What the provider receives Default: while a CLI is connected, the status code and body the local app returned, within 8 seconds; otherwise 200 and the request is stored for later. Response headers from the local app are never passed through. ## Limits (Free plan) 1 endpoint, 100 stored requests, 24 hours of history, 10 edited replays a month to localhost (a replay counts when its method, path, headers or body were changed; unchanged replays are unlimited; resets on the 1st, UTC; over it, `POST /api/requests/{id}/replay` answers 402 with `free_edits_left` and `resets`). Replay to a URL, re-signing and signature checks are on Solo and Pro. Paid plans (Solo $9/month, Pro $19/month, yearly with two months free) are listed at https://webhooklocal.com/pricing; upgrade from Settings → Billing (Paddle checkout) when it is open on the server. ## Not available yet (planned, not built) Signature checks for providers other than Stripe and GitHub; team members; alerts; custom subdomains. ## Using with an AI coding tool Register the MCP server (`claude mcp add webhooklocal -- wl mcp`) so the agent can list, read and replay requests itself, or use the --json commands from a script. Run `wl listen ` in a terminal the tool can read so it sees real requests and the app's responses. Use Copy as cURL to hand it a request's method, path, headers and text body. Replay stored requests after each change instead of re-triggering the provider. Webhook payloads contain customer data and provider secrets; whatever the tool reads is sent to its model provider. ## Contact hello@webhooklocal.com. Security reports: security@webhooklocal.com.