# MCP Events bridge

> MCP Events bridge is an open-source MCP server for developer tools. Turn webhooks from Resend, GitHub or Stripe into events an AI agent can subscribe to. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/hookdeck/mcp-events-bridge
- **MCP Registry name:** io.github.hookdeck/mcp-events-bridge
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

MCP Events is an experimental extension that lets an agent subscribe instead of polling, but few servers implement it while almost every service sends webhooks. This bridge sits in between: Hookdeck Event Gateway receives and verifies each webhook, and the bridge is the MCP server that lists available events, handles subscribe and keeps one Event Gateway connection per subscription. Events do not pass through the bridge, and it keeps no database.

Sources include Resend inbound email, GitHub, any of 163 Event Gateway source types such as Stripe, Slack and Shopify, and generic HTTP senders verified by HMAC, Standard Webhooks, Basic auth or an API key. Subscribers can filter, for example by an email's sender or a GitHub repository and action. Event Gateway retries failed deliveries, drops duplicates within an hour and records every attempt.

Clients that support MCP Events, such as ChatGPT, Hermes Agent, the Vercel AI SDK and Mastra, get webhook delivery. Claude Code, Codex and Cursor's CLI poll with wait_for_event and poll_events. It needs Node 22.12 and a Hookdeck account, and the README marks it 0.9, open source and subject to change with the experimental spec.

## Features

- **Webhooks as events:** Converts incoming webhooks into MCP Events agents can subscribe to.
- **Many sources:** Resend, GitHub, 163 gateway source types and generic HTTP senders.
- **Subscriber filters:** Choose which events wake an agent, such as sender or repository.
- **Verified delivery:** Signature checks, retries, de-duplication and a record of attempts.
- **Polling fallback:** wait_for_event and poll_events for clients without MCP Events support.
- **Stateless design:** Each subscription is a gateway connection, with no database.

## Good for

- Wake an agent when an email arrives
- React to a new GitHub issue or failed workflow
- Feed Stripe or Shopify events to an agent
- Run a local bridge for an agent on a laptop

## Install

### Claude Code (Terminal)

```sh
claude 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 RESEND_API_KEY='<RESEND_API_KEY>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @hookdeck/mcp-events-bridge
```

### Claude Desktop (claude_desktop_config.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>",
        "RESEND_API_KEY": "<RESEND_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.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>",
        "RESEND_API_KEY": "<RESEND_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### VS Code (.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>",
        "RESEND_API_KEY": "<RESEND_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.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>",
        "RESEND_API_KEY": "<RESEND_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>",
        "RESEND_API_KEY": "<RESEND_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

## Tools

- `wait_for_event`: Wait for an event during a turn (polling clients).
- `poll_events`: Poll for pending events.

## FAQ

### Which clients get push delivery?

Those supporting MCP Events: ChatGPT, Hermes Agent, the Vercel AI SDK, Mastra and TanStack AI are listed.

### Does Claude Code support it?

Claude Code polls instead, using wait_for_event and poll_events, and a plugin that runs watch between prompts.

### What do I need to run it?

Node 22.12 or later, a Hookdeck account with an API key and signing secret, the Hookdeck CLI for local runs, and at least one source.

### Is it stable?

The README calls MCP Events experimental and says the package may change with it.

### Is MCP Events bridge free?

Yes. MCP Events bridge is open source, so you can use and self-host it for free.

### How do I add MCP Events bridge to Claude Code?

Run this command in your terminal: claude 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 RESEND_API_KEY='<RESEND_API_KEY>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @hookdeck/mcp-events-bridge

### What are the best alternatives to MCP Events bridge?

The closest alternatives to MCP Events bridge are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mcp-events-bridge
