MCP Directory

How to add Discord MCP Server (IQAI) to Windsurf

Discord MCP with messaging, forums, reactions, webhooks and sampling support Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 5★ · stdio · apikey

Windsurf config for Discord MCP Server (IQAI)

npx -y @iqai/mcp-discord --config <your-discord-bot-token>
{
  "mcpServers": {
    "discord-mcp-server-iqai": {
      "command": "npx",
      "args": [
        "-y",
        "@iqai/mcp-discord",
        "--config",
        "<your-discord-bot-token>"
      ],
      "env": {
        "DISCORD_TOKEN": "<your-discord-bot-token>"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Discord MCP Server (IQAI) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Discord MCP Server (IQAI)'s tools become available to Cascade.

Before you start

  • Node.js (recent LTS recommended) with npx, or pnpm if building from source
  • A Discord application with a bot and its token, from the Discord Developer Portal
  • The Message Content, Server Members, and Presence privileged intents enabled for the bot
  • The bot invited to your server with appropriate permissions (Administrator recommended for full functionality)
  • An MCP client that supports the sampling capability, if you want the bot to auto-respond to mentions

What Discord MCP Server (IQAI) can do in Windsurf

discord_login

Authenticate the bot with the configured token

discord_get_server_info

Retrieve guild/server details

discord_send

Post a message to a text channel

discord_read_messages

Read messages from a channel (default limit 50)

discord_delete_message

Delete a specific message

discord_create_text_channel / discord_delete_channel

Create a text channel (optional topic) or delete a channel

discord_create_category / discord_edit_category / discord_delete_category

Create, edit (name/position), and delete categories

discord_get_forum_channels / discord_create_forum_post / discord_get_forum_post / discord_reply_to_forum / discord_delete_forum_post

List forums, create posts with optional tags, fetch a post, reply to threads, and delete posts

Security

A Discord bot token gives full bot access; scope the bot's gateway intents and server permissions tightly. Prefer the DISCORD_TOKEN env var over the --config flag to avoid the token appearing in process listings.

Discord MCP Server (IQAI) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Discord MCP Server (IQAI) config there under the "mcpServers" key and restart the client.

Is Discord MCP Server (IQAI) safe to use with Windsurf?

A Discord bot token gives full bot access; scope the bot's gateway intents and server permissions tightly. Prefer the DISCORD_TOKEN env var over the --config flag to avoid the token appearing in process listings.

What does the sampling feature do?

Sampling enables bi-directional communication: the bot listens for messages and, when mentioned, calls back to the host LLM to generate a reply automatically. It supports per-user rate limiting, message chunking, and optional AI-generated reactions, and requires an MCP client that implements the sampling capability.

How do I stop the bot from responding to everything?

By default RESPOND_TO_MENTIONS_ONLY is true and BLOCK_DMS is true, so it only reacts to mentions and ignores DMs. You can further restrict it with BLOCKED_GUILDS, BANNED_USERS, and DEFAULT_RATE_LIMIT_SECONDS.

Can I disable auto-responses entirely?

Yes. Set SAMPLING_ENABLED to false to turn off automatic mention responses while still using the explicit MCP tools.

View repo Full Discord MCP Server (IQAI) page