How to Use the Convoy MCP in Windsurf

Stop switching tabs to manage webhooks. Connect Convoy to Windsurf and let Cascade handle your event delivery and endpoint lifecycle.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Convoy MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full webhook control in Windsurf

Cascade can now call `create_endpoint` or `update_endpoint` directly from your chat. It reads your project structure and configures your webhook infrastructure without you leaving the editor. When you need to test connections, tell your agent to use `broadcast_event`. It executes the call and shows you the response in the same window, keeping your flow entirely within the IDE.

Automated delivery monitoring

Never guess why a request failed. Ask Cascade to check your delivery logs using `list_delivery_attempts` or `get_delivery_attempt` to see exactly what happened. If you find a broken request, have the agent run `retry_event_delivery` or `batch_retry_event_deliveries`. It fixes the delivery on the fly while you continue writing code.

Managing complex subscriptions

Cascade handles your subscription logic by invoking `create_subscription` and `create_filter` based on your project requirements. It keeps your event routing clean and documented. For larger setups, use `bulk_onboard` to migrate existing endpoints into your current project. The agent executes these tasks in sequence, saving you from manual API calls.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "convoy-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 Convoy. 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.