Discord (Via message)

Use the message tool. No provider-specific discord tool exposed to the agent.

Musts

• Always: channel: "discord".
• Respect gating: channels.discord.actions.* (some default off: roles, moderation, presence, channels).
• Prefer explicit ids: guildId, channelId, messageId, userId.
• Multi-account: optional accountId.

Targets

• Send-like actions: to: "channel:<id>" or to: "user:<id>".
• Message-specific actions: channelId: "<id>" (or to) + messageId: "<id>".

Common Actions (Examples)

Send message:

json
1{
2  "action": "send",
3  "channel": "discord",
4  "to": "channel:123",
5  "message": "hello",
6  "silent": true
7}

Send with media:

json
1{
2  "action": "send",
3  "channel": "discord",
4  "to": "channel:123",
5  "message": "see attachment",
6  "media": "file:///tmp/example.png"
7}

React:

json
1{
2  "action": "react",
3  "channel": "discord",
4  "channelId": "123",
5  "messageId": "456",
6  "emoji": "✅"
7}

Read:

json
1{
2  "action": "read",
3  "channel": "discord",
4  "to": "channel:123",
5  "limit": 20
6}

Edit / delete:

json
1{
2  "action": "edit",
3  "channel": "discord",
4  "channelId": "123",
5  "messageId": "456",
6  "message": "fixed typo"
7}

json
1{
2  "action": "delete",
3  "channel": "discord",
4  "channelId": "123",
5  "messageId": "456"
6}

Poll:

json
1{
2  "action": "poll",
3  "channel": "discord",
4  "to": "channel:123",
5  "pollQuestion": "Lunch?",
6  "pollOption": ["Pizza", "Sushi", "Salad"],
7  "pollMulti": false,
8  "pollDurationHours": 24
9}

Pins:

json
1{
2  "action": "pin",
3  "channel": "discord",
4  "channelId": "123",
5  "messageId": "456"
6}

Threads:

json
1{
2  "action": "thread-create",
3  "channel": "discord",
4  "channelId": "123",
5  "messageId": "456",
6  "threadName": "bug triage"
7}

Search:

json
1{
2  "action": "search",
3  "channel": "discord",
4  "guildId": "999",
5  "query": "release notes",
6  "channelIds": ["123", "456"],
7  "limit": 10
8}

Presence (often gated):

json
1{
2  "action": "set-presence",
3  "channel": "discord",
4  "activityType": "playing",
5  "activityName": "with fire",
6  "status": "online"
7}

Writing Style (Discord)

• Short, conversational, low ceremony.
• No markdown tables.
• Prefer multiple small replies over one wall of text.