MCP Events bridge
Turn webhooks from Resend, GitHub or Stripe into events an AI agent can subscribe to
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Remotely
- Version
- 0.11.0
- Listing updated
- today
Similar MCP servers
About MCP Events bridge
MCP Events bridge is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
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.
Install
Run in a 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-bridgeAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
HOOKDECK_API_KEYAPI key of the Hookdeck project the bridge uses (project settings, Secrets).RequiredHOOKDECK_SIGNING_SECRETSigning secret of the same Hookdeck project. Verifies Event Gateway's notifications to the bridge.RequiredBRIDGE_MCP_SECRETThe MCP endpoint's secret. `setup` generates one on its first run.RequiredBRIDGE_PORTPort the bridge listens on.RESEND_API_KEYFor the Resend source (inbound email). Needs permission to create webhooks.GITHUB_TOKENFor the GitHub source in automatic mode. Fine-grained token with Webhooks (read and write). Only `setup` uses it.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- wait_for_event
- Wait for an event during a turn (polling clients).
- poll_events
- Poll for pending events.
What it does
- 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
Pricing
Open source
Open source; requires a Hookdeck account
MCP Events bridge 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.


