discord

1# Discord
2 
3## Purpose
4Read and write Discord through a bot token: list servers the bot belongs to, list channels in a server, read recent message history, post messages, and open a DM to send a message. Use when the user mentions Discord or a Discord server.
5 
6## Tooling
7All commands go through `bin/discord.py`:
8 
9```bash
10bin/discord.py auth                                   # verify the bot token
11bin/discord.py guilds                                 # list servers the bot joined
12bin/discord.py channels --guild 112233445566778899    # list channels in a server
13bin/discord.py history --channel 112233445566778899 --limit 25  # read recent messages
14bin/discord.py send --channel 112233445566778899 --text "Ship it"  # post a message
15bin/discord.py dm --user 112233445566778899 --text "Hi"            # open a DM and send
16```
17 
18IDs are the numeric Discord snowflakes; copy them from `guilds`, `channels`, or Discord's Copy ID menu.
19 
20## Auth
21- Provider id: `discord` (credential is collected as `custom.discord`)
22- Collection: bot token via the secure credential flow (`credentials.request_api_access`); create the application at the Discord Developer Portal, copy the bot token, and invite the bot to each server with View Channel and Send Messages permissions
23- Scopes: none (bot token auth)
24- Allowed hosts: `discord.com`
25- Status check: `bin/discord.py auth` (must return `"ok": true`)
26 
27## Operating Rules
28…