Hooklistener — Claude Code MCP server: webhook and tunnel testing
Hooklistener — an MCP server for testing webhooks, inboxes, WebSockets and localhost tunnels. The agent creates a public URL, waits for a request, verifies the signature and replays it to localhost.
no license updated 2026-09-26
claude mcp add --transport http mcp https://app.hooklistener.com/api/mcpWhat Hooklistener does
Hooklistener runs over HTTP without local installation: the agent connects to https://app.hooklistener.com/api/mcp via OAuth or an API key and gets 67 tools. Endpoint creation, request waiting (wait_for_request), Stripe/GitHub/Slack signature verification, replay to localhost with body editing and signature recalculation, JSON Schema validation, diffing two requests, and saving test suites for replay.
For email there are create_inbox and wait_for_email: the agent signs up on staging with a temporary address and reads the verification code. WebSocket, Socket.IO, MQTT and SSE are covered by a separate toolset. The read_only mode allows only reading and diagnostics, blocking creation, deletion and sending. Without an account the agent creates a temporary URL that the user can claim later.
Secrets in headers, cookies and request bodies are masked in tool output. Replay and forwarding require an idempotency key: a retried tool call will not send the webhook twice.
What it helps with
- test Stripe webhooks end to end without ngrok
- read a verification code from an email when signing up on staging
- verify a GitHub webhook signature and forward to localhost
- save the last three webhooks as a test suite and run it after a fix
- debug a WebSocket connection with a public endpoint
Example prompts for the agent
- Create a Stripe endpoint, trigger a test checkout and wait for
checkout.session.completed - Verify this webhook's signature with my Stripe secret and replay it to
http://localhost:3000/webhooksre-signed
How to install Hooklistener
Platform CLI: remote server
claude mcp add --transport http mcp https://app.hooklistener.com/api/mcpPlatform CLI: remote server
codex mcp add hooklistener --url https://app.hooklistener.com/api/mcpConfig file
{
"mcpServers": {
"hooklistener": {
"url": "https://app.hooklistener.com/api/mcp"
}
}
}Config file
{
"servers": {
"hooklistener": {
"type": "http",
"url": "https://app.hooklistener.com/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http hooklistener https://app.hooklistener.com/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Hooklistener
How do I install Hooklistener in Claude Code?
Run claude mcp add --transport http hooklistener https://app.hooklistener.com/api/mcp, then run /mcp in Claude Code, select hooklistener and sign in with your browser.
What does Hooklistener do?
It gives the agent tools for testing webhooks, email, WebSockets and localhost tunnels: creating a public URL, waiting for a request, verifying the signature, replaying to a local server with body edits.
Do I need a Hooklistener account?
No, the agent can create a temporary webhook URL without an account. The user can claim it later if needed.