How to Use the Hookdeck (Webhook Gateway) MCP in Windsurf

Q: What's the best way to debug a connection with Hookdeck (Webhook Gateway) and Windsurf?

Start by asking Windsurf to run getconnection to see the configuration. Then, use listevents to see what's being processed and geteventraw to inspect a specific payload. Since Cascade can chain tools, you can simply ask it, "Why did this event fail?" and it will trace the steps for you.

Let Windsurf's Cascade agent autonomously manage your entire Hookdeck webhook pipeline, from setup to incident response.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hookdeck (Webhook Gateway) MCP to Windsurf

Create your Vinkius account to connect Hookdeck (Webhook Gateway) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Hookdeck (Webhook Gateway) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Set Up Connections Without a Single Click

Use `create_connection` and let Windsurf's Cascade agent handle the rest. You don't need to manually configure inputs and outputs. Just tell Cascade what you want to connect, and it will chain together `create_source` and `create_destination` calls before linking them. This is what happens when your agent can plan. Give it a goal like, "Route our new Shopify order webhooks to the ingestion API," and watch it work. Cascade finds the tools, calls them in the right order, and reports back when the connection is live. No forms, no GUIs, just results.

Autonomous Incident Response

The `bulk_retry_events` tool lets your agent fix delivery failures for you. When things break—and they will—you don't have to go digging through logs. Cascade can be configured to watch for problems, diagnose them, and solve them. Just tell Windsurf, "Fix the failed webhooks from last night." It can use `get_metrics_events_by_issue` to find the root cause, `list_events` to gather the affected IDs, and `bulk_retry_events` to re-process the entire batch. It's your own automated SRE for webhooks.

Monitor Webhook Health with Windsurf

This MCP Server exposes all of Hookdeck's critical health metrics. You can ask your agent to check throughput with `get_metrics_events`, monitor backlogs with `get_metrics_queue_depth`, or analyze delivery patterns with `get_metrics_attempts`. It's better than a dashboard because it's interactive. Ask Cascade, "Is our webhook system healthy?" It will pull the data, spot the anomalies, and tell you if the queue is growing or the failure rate is spiking. You get answers, not just charts.

Setup guide

Set up Hookdeck (Webhook Gateway) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Hookdeck (Webhook Gateway) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Hookdeck (Webhook Gateway) payment history." If connected, Cascade will call the Hookdeck (Webhook Gateway) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "hookdeck-webhook-gateway-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Hookdeck. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Hookdeck (Webhook Gateway) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Hookdeck (Webhook Gateway) MCP in Windsurf

You can install it directly from the MCP Marketplace inside Windsurf. Just search for Hookdeck and click install. Alternatively, add the server URL to your `mcp_config.json` file and refresh the MCP panel.

Yes, that's a core use case. You can instruct the Cascade agent to monitor for issues using `list_issues` and then trigger `bulk_retry_events` based on the query it finds. It's a powerful way to automate recovery.

Start by asking Windsurf to run `get_connection` to see the configuration. Then, use `list_events` to see what's being processed and `get_event_raw` to inspect a specific payload. Since Cascade can chain tools, you can simply ask it, "Why did this event fail?" and it will trace the steps for you.

Absolutely. The server includes tools for the full lifecycle: `create_source`, `update_source`, `delete_source`, and the same for destinations. You can tell your agent to provision, modify, or tear down any part of the webhook plumbing.

Data privacy is handled by Vinkius's ephemeral architecture. The server primarily processes connection settings and event metadata. Any raw event payloads you inspect with `get_event_raw` are streamed directly to your client and are never stored by the MCP server itself.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript