Webhook.site MCP Server — Claude Code MCP server: install guide
Captures inbound HTTP requests, emails, and DNS lookups right inside coding sessions. Useful when debugging API callbacks, validating webhooks, and running security tests.
claude mcp add webhook-mcp-server -- uvx webhook-mcp-serverWhat Webhook.site MCP Server does
The server equips coding assistants with 31 tools to inspect incoming events via webhook.site. It catches HTTP requests and observes outbound DNS queries. Without an account, all generated endpoints remain active for 7 days. Setting WEBHOOK_SITE_API_KEY makes URLs permanent and enables scheduled actions.
Setup requires Python 3.10+ alongside uvx. Version 3.0.0 or higher is mandatory. Older builds such as 2.1.3 fail to start on MCP 2.0 because of protocol changes.
Payload generators for blind SSRF belong strictly on authorized targets. When inspecting email links, the tool rejects private IP addresses to block rebinding attempts. To test against local development servers, add them to FOLLOW_EMAIL_LINK_ALLOW_HOSTS.
What it helps with
- inspect incoming HTTP callbacks during API integration tests
- fetch confirmation links from disposable email inboxes
- monitor outbound DNS queries to detect network activity
- place canary tokens to trace unauthorized configuration access
Example prompts for the agent
- Create a temporary webhook URL and wait for the next incoming POST payload.
- Generate a disposable inbox and extract the verification link from the email.
- Mock an endpoint that responds with status 404 and a five-second delay.
How to install Webhook.site MCP Server
Platform CLI
claude mcp add webhook-mcp-server -- uvx webhook-mcp-serveruvx runs the command named after the package; if the README names another one, use uvx --from webhook-mcp-server <command>
Platform CLI
codex mcp add webhooksite-mcp-server -- uvx webhook-mcp-serveruvx runs the command named after the package; if the README names another one, use uvx --from webhook-mcp-server <command>
Config file
{
"mcpServers": {
"webhooksite-mcp-server": {
"command": "uvx",
"args": [
"webhook-mcp-server"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from webhook-mcp-server <command>
Config file
{
"servers": {
"webhooksite-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"webhook-mcp-server"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from webhook-mcp-server <command>
Platform CLI
gemini mcp add webhooksite-mcp-server uvx webhook-mcp-serveruvx runs the command named after the package; if the README names another one, use uvx --from webhook-mcp-server <command>
Step 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 Webhook.site MCP Server
How to install Webhook.site MCP Server in Claude Code?
Run claude mcp add webhook-mcp-server -- uvx webhook-mcp-server in your terminal.
What does Webhook.site MCP Server do?
It connects your coding environment to webhook.site to inspect webhooks, receive temporary emails, and log DNS queries.
Is a paid webhook.site subscription required?
No, anonymous URLs operate without an account and expire after 7 days. An API key is only needed for persistent tokens and actions.
