Discord MCP

Connect your Discord bot to MCP clients — list servers, send messages, moderate members, search message history with RAG, and run agentic workflows from Cursor or Claude Desktop.

v0.2.0 · 36 operations · FastMCP 3.2 · Comms lane · Releases

Contents

• Features

• Quick start

• What you can do

• Ports

• Documentation

• Requirements

Related MCP server: Discord Notifications MCP Server

Features

• 36 Discord operations in one portmanteau tool — messaging, moderation, roles, webhooks, audit log, RAG

• Fleet web dashboard — guilds, channels, messages, agentic chat, LanceDB search (ports 10756 / 10757)

• Agentic workflow — describe a goal; server uses sampling + tools (SEP-1577)

• Dual transport — stdio for IDE hosts, streamable HTTP at /mcp for remote clients

• Built-in safety — anti-spam rate limits, Discord 429 auto-retry, bind localhost only

• Bundled skills & prompts — moderation playbook, RAG workflow, ops guides

Quick start

git clone https://github.com/sandraschi/discord-mcp
cd discord-mcp
.\start.ps1

1. Copy .env.example → .env and set DISCORD_TOKEN (bot setup)

2. Open dashboard http://127.0.0.1:10757 · API http://127.0.0.1:10756

Other install paths (just, Cursor, Claude Desktop, no-git): INSTALL.md

What you can do

List servers and post a message

List my Discord guilds, then send "Fleet check-in OK" to channel #general in the first server.

Moderation assist

Show recent audit log entries for guild 123456789 and summarize ban/kick events from the last 24 hours.

Search ingested history

Ingest the last 50 messages from #dev, then answer: what did we decide about the CI workflow?

Ports

Documentation

Fleet central mirror: mcp-central-docs/projects/discord-mcp

Requirements

• Windows (primary; fleet dev target) or macOS/Linux with Python 3.12+

• uv for Python deps · Node 20+ for the webapp

• Discord bot token — free at Discord Developer Portal

• Optional: Ollama for local agentic sampling when the MCP host has no LLM

Repository: github.com/sandraschi/discord-mcp