# MCP Events bridge

MCP Events bridge — an MCP server for Claude Code that turns incoming webhooks into MCP Events for AI agents via Hookdeck Event Gateway.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: hookdeck
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hookdeck/mcp-events-bridge
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-events-bridge

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HOOKDECK_API_KEY`, `HOOKDECK_SIGNING_SECRET`, `BRIDGE_MCP_SECRET`, `BRIDGE_PORT`, `RESEND_API_KEY`, `GITHUB_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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-bridge
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-bridge
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- 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
- 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

## Similar
- [hookdeck-event-gateway](https://affpapa.org/en/nevibecode/skills/hookdeck-event-gateway.md) — skill · 214 installs
- [cursor-webhooks](https://affpapa.org/en/nevibecode/skills/cursor-webhooks.md) — skill · 200 installs
- [vercel-webhooks-events](https://affpapa.org/en/nevibecode/skills/vercel-webhooks-events.md) — skill · 1 install
- [inngest-events](https://affpapa.org/en/nevibecode/skills/inngest-events.md) — skill · 4000 installs
- [maintainx-webhooks-events](https://affpapa.org/en/nevibecode/skills/maintainx-webhooks-events.md) — skill · 1 install
- [gateway-workers](https://affpapa.org/en/nevibecode/skills/gateway-workers.md) — skill · 25500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
