How to Use the Amazon EventBridge Bus MCP in Windsurf

Q: How does Windsurf use the Amazon EventBridge Bus MCP Server?

Windsurf's Cascade agent uses the putevents tool to send custom events to your bus. This allows it to trigger downstream AWS services, log application events, or integrate with your existing event-driven architecture, all without leaving the IDE.

Let Windsurf's Cascade agent send events directly to your Amazon EventBridge Bus. No more manual trips to the AWS console.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Amazon EventBridge Bus MCP to Windsurf

Create your Vinkius account to connect Amazon EventBridge Bus 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 Amazon EventBridge Bus with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Fire Events from Your IDE

The `put_events` tool gives your agent a direct line to a specific Amazon EventBridge Bus. No more context switching to send a test event or trigger a workflow. It's a simple, focused operation available right in your editor. Now, Windsurf's Cascade agent can react to what you're doing. Ask it to 'send a `user-signup` event with this test data,' and it just does it. Cascade can read your code, find the right data, and use this tool to push the event, all as part of one command.

Build Autonomous Workflows

Connect this MCP Server and Cascade immediately sees the new capability. You can set up rules like, 'When this integration test fails, send a failure event to the monitoring bus.' Cascade plans the sequence and executes it automatically. This isn't just about calling one tool. It's about Windsurf chaining actions together. Your agent can read a log file, spot an error, and then use `put_events` to notify another service. You set the goal, and Cascade handles the steps.

Scoped Access for Your Windsurf Agent

This server is locked down to a single EventBus. That means your agent can't accidentally hit the wrong target or wander into other AWS services. It's a secure, direct line for dispatching events and nothing else. You don't have to manage complex IAM roles for your agent, either. Just connect this MCP Server, and Windsurf gets the exact permission it needs: sending events to one bus. That's it. It's a zero-trust approach that keeps things simple and safe.

Setup guide

Set up Amazon EventBridge Bus 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 Amazon EventBridge Bus 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 Amazon EventBridge Bus payment history." If connected, Cascade will call the Amazon EventBridge Bus tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "amazon-eventbridge-bus-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 Amazon EventBridge Bus. 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 Amazon EventBridge Bus 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 Amazon EventBridge Bus MCP in Windsurf

Windsurf's Cascade agent uses the `put_events` tool to send custom events to your bus. This allows it to trigger downstream AWS services, log application events, or integrate with your existing event-driven architecture, all without leaving the IDE.

It's a one-click install from Windsurf's built-in MCP Marketplace. You can also add it manually in your `mcp_config.json` file. Once connected, Cascade auto-discovers the `put_events` tool and can start using it immediately.

Yes. If you have a Lambda function subscribed to your Amazon EventBridge Bus, you can have Windsurf's agent send an event that triggers it. Your agent just needs to send the right event pattern; EventBridge handles the rest.

Yes, much more. The server is scoped to one action on one EventBus, which drastically limits the blast radius. Your Vinkius token handles authentication, so you never have to store AWS credentials in your local configuration.

It only processes the custom event payloads your agent sends via the `put_events` tool. The server itself is ephemeral and logs nothing. Your Vinkius token authenticates the connection, and all traffic is encrypted end-to-end.

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