MCP Events bridge — Claude Code MCP server: what it does
MCP Events bridge — an MCP server for Claude Code that turns incoming webhooks into MCP Events for AI agents via Hookdeck Event Gateway.
MIT ★ 9 updated 2026-11-16
claude mcp add mcp-events-bridge -e HOOKDECK_API_KEY=<HOOKDECK_API_KEY> -e HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> -e BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> -e RESEND_API_KEY=<RESEND_API_KEY> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @hookdeck/mcp-events-bridgeWhat MCP Events bridge does
The bridge converts webhooks from services like GitHub and Resend into MCP Events so agents react instantly instead of polling. Hookdeck Event Gateway verifies signatures, retries failed deliveries, and records every request. Running it requires environment variables HOOKDECK_API_KEY, HOOKDECK_SIGNING_SECRET, BRIDGE_MCP_SECRET, and RESEND_API_KEY.
Clients supporting MCP Events receive webhooks directly, while Claude Code polls the bridge using wait_for_event and poll_events. The architecture remains stateless without a database, mapping each subscription directly to an Event Gateway connection. The Hookdeck CLI forwards events locally without requiring a public URL.
Subscriptions include filters by email sender or GitHub action to wake agents only for relevant triggers. The package is open source and runs via npx through Node.js.
What it helps with
- receive GitHub CI failure alerts inside the coding agent
- process incoming Resend emails directly within the agent
- filter webhook events by repository and action parameters
- handle external service events without continuous polling
Example prompts for the agent
- Wait for a webhook event using the bridge tools
- Poll for recent webhook events with
poll_events - Subscribe to incoming Resend emails inside the agent
How to install MCP Events bridge
Platform CLI
claude mcp add mcp-events-bridge -e HOOKDECK_API_KEY=<HOOKDECK_API_KEY> -e HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> -e BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> -e RESEND_API_KEY=<RESEND_API_KEY> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @hookdeck/mcp-events-bridgeReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add mcp-events-bridge --env HOOKDECK_API_KEY=<HOOKDECK_API_KEY> --env HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> --env BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> --env BRIDGE_PORT=<BRIDGE_PORT> --env RESEND_API_KEY=<RESEND_API_KEY> -- npx -y @hookdeck/mcp-events-bridgeReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"mcp-events-bridge": {
"command": "npx",
"args": [
"-y",
"@hookdeck/mcp-events-bridge"
],
"env": {
"HOOKDECK_API_KEY": "<HOOKDECK_API_KEY>",
"HOOKDECK_SIGNING_SECRET": "<HOOKDECK_SIGNING_SECRET>",
"BRIDGE_MCP_SECRET": "<BRIDGE_MCP_SECRET>",
"BRIDGE_PORT": "<BRIDGE_PORT>",
"RESEND_API_KEY": "<RESEND_API_KEY>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"mcp-events-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hookdeck/mcp-events-bridge"
],
"env": {
"HOOKDECK_API_KEY": "<HOOKDECK_API_KEY>",
"HOOKDECK_SIGNING_SECRET": "<HOOKDECK_SIGNING_SECRET>",
"BRIDGE_MCP_SECRET": "<BRIDGE_MCP_SECRET>",
"BRIDGE_PORT": "<BRIDGE_PORT>",
"RESEND_API_KEY": "<RESEND_API_KEY>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e HOOKDECK_API_KEY=<HOOKDECK_API_KEY> -e HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> -e BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> -e BRIDGE_PORT=<BRIDGE_PORT> -e RESEND_API_KEY=<RESEND_API_KEY> mcp-events-bridge npx -y @hookdeck/mcp-events-bridgeReplace <…> with your own values. 1 more environment variable is in the server README
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 MCP Events bridge
How to install MCP Events bridge in Claude Code?
Run `claude mcp add mcp-events-bridge -e HOOKDECK_API_KEY=<HOOKDECK_API_KEY> -e HOOKDECK_SIGNING_SECRET=<HOOKDECK_SIGNING_SECRET> -e BRIDGE_MCP_SECRET=<BRIDGE_MCP_SECRET> -e RESEND_API_KEY=<RESEND_API_KEY> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y @hookdeck/mcp-events-bridge` in your terminal.
What does MCP Events bridge do?
It turns webhooks from any HTTP sender into standardized MCP Events so AI agents react the moment something happens.
What is needed to run MCP Events bridge?
It requires environment variables HOOKDECK_API_KEY, HOOKDECK_SIGNING_SECRET, BRIDGE_MCP_SECRET, RESEND_API_KEY, and GITHUB_TOKEN.