How to Use the Discord MCP in Windsurf

Q: How do I connect Discord to Windsurf?

Add the server configuration to your mcpconfig.json file. Windsurf will pick it up and show the available tools in the Cascade interface.

Windsurf connects directly to your Discord via this MCP Server to manage guilds and automate messaging without leaving your editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Discord MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate server tasks with Windsurf

Cascade uses `list_guilds` and `list_channels` to map your community structure instantly. It sees exactly what's happening so you don't have to navigate menus. Once it identifies a target, it uses `send_message` or `create_dm_channel` to handle engagement. It turns your intent into direct API calls.

Real-time guild data inside Windsurf

Feed live data into your workflow by calling `get_guild` or `list_guild_members`. You get the exact state of your community without switching context. Windsurf pulls this data into the chat window, letting you cross-reference user info via `get_user` during your development cycle.

Manage channel activity in Windsurf

Fetch recent context using `list_messages` to see what your users are actually saying. It's the fastest way to get up to speed on a thread. Use `get_channel` to verify permissions and settings. You keep full control over your server configuration without needing a browser.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "discord-alternative-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 Discord. 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 Discord 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 Discord MCP in Windsurf

Add the server configuration to your `mcp_config.json` file. Windsurf will pick it up and show the available tools in the Cascade interface.

The server only accesses data allowed by your bot token's scopes. You define the permissions, and the MCP Server executes requests only when you trigger them.

No. The connection is light and only hits the API when you invoke a tool. It won't slow down your editor during coding sessions.

The tool will return an error code. Since it's a direct connection, you'll see the failure immediately in the Cascade chat log.

Your bot token and server data stay within your local environment. We don't store your guild or member data on our servers.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python