Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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
Open on GitHub

What 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-bridge

Replace <…> 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.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open