discord

Discord

Interact with Discord using the built-in MCP tools provided by the nomos-discord server. These tools call the Discord REST API directly — no curl commands or shell environment variables needed.

Available Tools

Messaging

| Tool | Description | | ------------------------ | ----------------------------------------------------- | | discord_send_message | Send a text message to a channel or thread | | discord_send_embed | Send a rich embed (title, description, color, footer) | | discord_edit_message | Edit an existing message | | discord_delete_message | Delete a message |

Reading & Search

| Tool | Description | | ---------------------- | --------------------------------------------------------- | | discord_read_channel | Read recent messages from a channel or thread | | discord_search | Search messages in a guild by content, author, or channel |

Reactions & Pins

| Tool | Description | | ----------------------- | --------------------------------- | | discord_react | Add a reaction emoji to a message | | discord_pin_message | Pin a message | | discord_unpin_message | Unpin a message | | discord_list_pins | List pinned messages in a channel |

Threads

| Tool | Description | | ----------------------- | -------------------------------------------------------- | | discord_create_thread | Create a thread from a message or as a standalone thread |

Info

| Tool | Description | | ----------------------- | ----------------------------------------------------------------------- | | discord_list_channels | List all channels in a guild (text, voice, category, forum, etc.) | | discord_member_info | Get details about a guild member (username, nickname, roles, join date) |

Usage Examples

Send a message

Use discord_send_message with a channel ID and content text.

Send a rich embed

Use discord_send_embed for formatted announcements or status updates. Supports title, description (markdown), color (decimal integer), and footer.

Common colors: green = 5763719, red = 15548997, blue = 3447003, yellow = 16705372, purple = 10181046.

Read channel history

Use discord_read_channel with a channel or thread ID. Returns messages with timestamps, IDs, and usernames.

Create a thread

Use discord_create_thread with a channel ID and name. Optionally attach it to an existing message with message_id.

Search messages

Use discord_search with a guild ID. Filter by content text, author ID, or channel ID.

Find a channel

Use discord_list_channels with a guild ID to discover channel IDs, names, and types.

Writing Style (Discord)

• Short, conversational, low ceremony.
• Avoid Markdown tables — Discord renders them poorly.
• Mention users as <@USER_ID>, channels as <#CHANNEL_ID>, roles as <@&ROLE_ID>.
• Use Discord markdown: bold, italic, > quote, ` code , ``codeblock` .
• Embeds support richer formatting than plain messages.

Autonomous Discord Monitoring

Nomos can autonomously monitor Discord channels in the background using the daemon. When a user asks you to "watch my Discord", "monitor channels", or "listen for messages", take action directly — don't just show commands, run them yourself:

1. Check if the daemon is running: nomos daemon status
2. If not running, start it: nomos daemon start — it connects to Discord automatically when DISCORD_BOT_TOKEN is configured
3. Check current cron jobs: nomos cron list
4. Create a custom monitoring loop for periodic checks: nomos cron create discord-watch "/15 *" --prompt "<instructions>"

Always execute these commands yourself using Bash rather than telling the user to run them. If a command is blocked by permission hooks, show the user the exact command so they can run it. Confirm what you did after.

Tips

• Snowflake IDs: all Discord IDs are large integers as strings
• Channel types: 0=text, 2=voice, 4=category, 5=announcement, 11=public-thread, 12=private-thread, 13=stage, 15=forum
• Rate limits: 5 req/5sec per route. The tools handle errors automatically.
• Required bot permissions: SEND_MESSAGES, READ_MESSAGE_HISTORY, ADD_REACTIONS, MANAGE_MESSAGES, MANAGE_THREADS, CREATE_PUBLIC_THREADS
• Bot invite URL: https://discord.com/api/oauth2/authorize?client_id={CLIENT_ID}&permissions={PERMS}&scope=bot