understudy-ai/discord

Discord (Via message_send)

Use the message_send tool. Understudy does not expose a separate provider-specific discord tool.

Musts

• Always: channel: "discord".
• Use the canonical message_send schema: recipient, text, threadId, replyTo, messageId, emoji, attachmentUrl, attachmentType, attachmentName, attachmentMimeType.
• Prefer explicit ids in the recipient string when possible, for example channel:1234567890 or user:1234567890.

Guidelines

• Avoid Markdown tables in outbound Discord messages.
• Mention users as <@USER_ID>.
• Keep Discord actions within the current Understudy tool surface. Do not invent unsupported fields such as components, embeds, pollQuestion, thread-create, search, or set-presence.

Targets

• Send-like actions: recipient: "channel:<id>" or recipient: "user:<id>".
• Message-specific actions: use messageId, and include recipient when the adapter needs target context.

Common Actions (Examples)

Send message:

{
  "action": "send",
  "channel": "discord",
  "recipient": "channel:123",
  "text": "hello"
}

Reply to a message:

{
  "action": "reply",
  "channel": "discord",
  "recipient": "channel:123",
  "replyTo": "456",
  "text": "Thanks, looking now."
}

Send with attachment:

{
  "action": "sendAttachment",
  "channel": "discord",
  "recipient": "channel:123",
  "text": "see attachment",
  "attachmentUrl": "/tmp/example.png",
  "attachmentType": "image",
  "attachmentName": "example.png"
}

{
  "action": "edit",
  "channel": "discord",
  "recipient": "channel:123",
  "messageId": "456",
  "text": "fixed typo"
}

{
  "action": "react",
  "channel": "discord",
  "recipient": "channel:123",
  "messageId": "456",
  "emoji": "✅"
}

{
  "action": "delete",
  "channel": "discord",
  "recipient": "channel:123",
  "messageId": "456"
}

If you need polls, search, thread creation, pins, moderation, or presence changes, tell the user the current Understudy tool surface does not expose those Discord-specific operations directly.

Writing Style (Discord)

• Short, conversational, low ceremony.
• No markdown tables.
• Mention users as <@USER_ID>.