How to Use the MagicBell MCP in Windsurf

Q: How do I connect MagicBell to Windsurf?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file. Once you refresh the MCP panel, Windsurf detects the tools and makes them available to Cascade.

Q: Can I use MagicBell to debug notification issues in Windsurf?

Absolutely. Use the getbroadcast tool to inspect specific notification payloads and delivery statuses without leaving your editor.

Trigger multi-channel notifications directly from your Windsurf agent without leaving your workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MagicBell MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous alert orchestration in Windsurf

Cascade reads your codebase and triggers `create_broadcast` when it detects a deployment failure or a critical system event. You define the goal, and the agent handles the payload structure for your notification channels. It removes the need for manual API calls or context switching between your terminal and the dashboard. Just tell Cascade what to send, and it executes the broadcast immediately.

Inspect broadcast history inside your MCP Server

Use `list_broadcasts` to pull your recent notification history into the Windsurf context window. This allows the agent to analyze past alert patterns and suggest improvements to your messaging cadence. It maps your existing notification data into the current development session. Cascade evaluates these logs to ensure your system alerts remain consistent across all environments.

Rapid broadcast retrieval for debugging

When you need to verify a specific alert, call `get_broadcast` to pull the exact metadata for any notification ID. This gives you a clear view of delivery status and channel routing directly within the IDE. It saves you from hunting through logs in external portals. The agent fetches the broadcast details and presents them in a clean format for your immediate review.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "magicbell-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 MagicBell. 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 MagicBell 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 MagicBell MCP in Windsurf

Add the server configuration to your ~/.codeium/windsurf/mcp_config.json file. Once you refresh the MCP panel, Windsurf detects the tools and makes them available to Cascade.

Yes. Since Cascade can chain actions, you can instruct it to run `create_broadcast` as part of a larger automated workflow, like sending an alert after a test suite finishes.

Your notification payloads and broadcast logs are transmitted securely to the MagicBell API. We do not store your API keys or sensitive broadcast content on our servers.

Windsurf will surface an error in the MCP panel. You can check the logs to see if the connection timed out or if your authentication credentials need updating.

Absolutely. Use the `get_broadcast` tool to inspect specific notification payloads and delivery statuses without leaving your editor.

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