Discp

⚡ Discp

The Feature-Complete Discord Model Context Protocol (MCP) Server

Providing any AI assistant (Claude Desktop, Claude Code, Cursor, Antigravity, OpenCode, Windsurf, n8n) with native, granular control over Discord.

📖 Overview

Discp is a production-grade Discord MCP server written in TypeScript. It bridges AI assistants to Discord with 117 native tools, supporting both User/Alt Accounts and Bot Accounts seamlessly without requiring bot verification or developer portal setup.

🛡️ Anti-Abuse Human Pacing (Zero Warning Flags)

To prevent accounts from triggering Discord security checkpoints, rate-limits, or password resets, Discp enforces natural human pacing (1.2s – 2.5s randomized intervals) across sensitive write operations (creating channels, roles, categories, webhooks, and assigning permissions).

🎨 Creative Variation (No Repetitive Designs)

Discp equips AI models with tools to discover fresh aesthetic symbols and channel architectures dynamically:

• get_discord_symbols: Curated offline library of dividers, channel prefixes, role badges, sparkles, and layout templates.
• search_discord_symbols: Searches online databases (emojicombos, emojidb) live on demand so every server gets unique aesthetics.
• get_discord_syntax_guide: Complete cheatsheet of Discord markdown techniques, timestamps, mentions, and internal navigation links.

🛠️ Complete Tool Catalog (117 Tools)

⚡ Quickstart

1. Clone & Build

git clone https://github.com/SharimAli/discp.git
cd discp
npm install
npm run build

2. Environment Configuration

Copy .env.example to .env:

# 'user' (for user/alt account token) or 'bot' (for Discord bot token)
DISCORD_ACCOUNT_TYPE=user

# Your Token
DISCORD_TOKEN=your_token_here

# Default Server ID (Optional: commands will default to this guild)
DISCORD_GUILD_ID=your_default_server_id_here

🔌 Client Integration Guides

1. Cursor IDE

In ~/.cursor/mcp.json or .cursor/mcp.json:

{
  "mcpServers": {
    "discp": {
      "command": "node",
      "args": ["/path/to/discp/dist/index.js"],
      "env": {
        "DISCORD_ACCOUNT_TYPE": "user",
        "DISCORD_TOKEN": "YOUR_DISCORD_TOKEN",
        "DISCORD_GUILD_ID": "YOUR_SERVER_ID"
      }
    }
  }
}

2. Claude (Desktop & Code CLI)

• Claude Desktop: Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS): json { "mcpServers": { "discp": { "command": "node", "args": ["/path/to/discp/dist/index.js"], "env": { "DISCORD_ACCOUNT_TYPE": "user", "DISCORD_TOKEN": "YOUR_DISCORD_TOKEN", "DISCORD_GUILD_ID": "YOUR_SERVER_ID" } } } }
• Claude Code CLI: bash claude mcp add discp node /path/to/discp/dist/index.js \ --env DISCORD_ACCOUNT_TYPE=user \ --env DISCORD_TOKEN="YOUR_DISCORD_TOKEN" \ --env DISCORD_GUILD_ID="YOUR_SERVER_ID"

3. Google Antigravity IDE

In ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "discp": {
      "command": "node",
      "args": ["C:\\path\\to\\discp\\dist\\index.js"],
      "env": {
        "DISCORD_ACCOUNT_TYPE": "user",
        "DISCORD_TOKEN": "YOUR_DISCORD_TOKEN",
        "DISCORD_GUILD_ID": "YOUR_SERVER_ID"
      }
    }
  }
}

4. OpenCode Desktop / OpenClaw

In opencode.json:

{
  "mcp": {
    "servers": {
      "discp": {
        "command": "node",
        "args": ["/path/to/discp/dist/index.js"],
        "env": {
          "DISCORD_ACCOUNT_TYPE": "user",
          "DISCORD_TOKEN": "YOUR_DISCORD_TOKEN",
          "DISCORD_GUILD_ID": "YOUR_SERVER_ID"
        }
      }
    }
  }
}

5. Other Editors (VS Code / Cline / Roo Code / Continue / Windsurf)

Use the standard MCP server definition in your tool's settings (cline_mcp_settings.json, ~/.codeium/windsurf/mcp_config.json, or .continue/config.json):

{
  "mcpServers": {
    "discp": {
      "command": "node",
      "args": ["/path/to/discp/dist/index.js"],
      "env": {
        "DISCORD_ACCOUNT_TYPE": "user",
        "DISCORD_TOKEN": "YOUR_DISCORD_TOKEN",
        "DISCORD_GUILD_ID": "YOUR_SERVER_ID"
      }
    }
  }
}

6. HTTP / SSE Mode (n8n, Flowise, Remote AI)

Run Discp as a persistent network microservice:

export MCP_TRANSPORT=http
export PORT=8085
node dist/index.js

• SSE Stream: http://localhost:8085/sse
• Messages: http://localhost:8085/messages
• Health Check: http://localhost:8085/health

💡 Discord Mention & Formatting Syntax

Tip: Enable resolveMentions: true in send_message or edit_message to automatically convert #general and @Moderator into native Discord clickable pills!

🎨 Recommended Aesthetic & Template Resources

When designing servers, AI assistants are encouraged to consult:

• EmojiCombos Discord Symbols — Channel prefixes & dividers
• EmojiDB Channel Symbols — Unicode symbol collections
• DiscordGate Symbols — Aesthetic text styles
• Scoplidrop Symbols — Decorative dividers & borders
• Xenon Templates — Community server architecture layouts

📜 License

Distributed under the MIT License. See LICENSE for more details.

⚠️ Disclaimer

• Discord Terms of Service: Automating user accounts (selfbots) is against Discord's Terms of Service and Community Guidelines. While Discp integrates natural human pacing (1.2s – 2.5s randomized intervals) to safeguard accounts, using user account tokens is done strictly at your own discretion and risk.
• Limitation of Liability: The authors and contributors assume no responsibility or liability for any account terminations, suspensions, rate limits, or sanctions enforced by Discord.
• Non-Affiliation: Discp is an independent open-source project and is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Discord Inc. or its affiliates.