# Discord Message Finder MCP

Read-only MCP server for finding Discord messages. It does not send, edit, delete, react to, or moderate messages. The tools are built around answering questions like "where was this discussed?", "which channel has the message?", and "show the context around this result."

## Features

- Search guild messages with Discord's native search filters.
- Locate a message from a Discord jump URL or channel/message IDs.
- Read context before and after a message.
- List searchable channels and active threads.
- Scan recent channel history when native guild search is not enough.
- Return stable Discord jump links, timestamps, channel IDs, author IDs, attachments, embeds, and readable snippets.

## Requirements

- Node.js 20 or newer.
- A Discord bot token.
- The bot must be in the target guild and have `View Channel` and `Read Message History` where you want to search.
- For message content search/results, enable the Discord `MESSAGE CONTENT INTENT` privileged intent for the application.

## Setup

```bash
npm install
npm run build
```

Create an environment file or configure your MCP client with these variables:

```bash
DISCORD_BOT_TOKEN=your_bot_token
DISCORD_DEFAULT_GUILD_ID=optional_default_guild_id
DISCORD_ALLOWED_GUILD_IDS=optional_comma_separated_allowlist
```

Example MCP client configuration:

```json
{
  "mcpServers": {
    "discord-search": {
      "command": "node",
      "args": ["/Users/dh/work/discord-mcp/build/index.js"],
      "env": {
        "DISCORD_BOT_TOKEN": "YOUR_BOT_TOKEN",
        "DISCORD_DEFAULT_GUILD_ID": "YOUR_GUILD_ID"
      }
    }
  }
}
```

## Tools

### `check_discord_access`

Checks whether the token works and whether a guild can be read.

### `list_guild_channels`

Lists guild channels and optionally active threads, with IDs and parent/category context.

### `search_guild_messages`

Uses Discord guild search to find messages by content, author, channel, mentions, attachments, links, pin status, and time/message bounds.

### `find_in_recent_history`

Scans recent message history across selected channels or matching channel names. This is useful when Discord search indexing is delayed or when you want a bounded recent-history search.

### `locate_message`

Fetches one exact message from a jump URL or channel/message IDs and returns where it lives.

### `get_message_context`

Fetches an exact message plus surrounding messages before and after it.

### `read_channel_messages`

Reads recent messages from a channel with Discord's `before`, `after`, or `around` pagination.

## Notes

Discord's native search can return an indexing response with a retry delay, and search access depends on the application's Message Content privileged intent. The server surfaces those responses explicitly instead of hiding them.