MCP Directory

How to add Discord MCP Server (IQAI) to Cursor

Discord MCP with messaging, forums, reactions, webhooks and sampling support Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Discord MCP Server (IQAI) config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Discord MCP Server (IQAI)'s tools to confirm it's connected.

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 Cursor

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) + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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