read_messages
Retrieves readable chat history from a Discord channel, thread, or DM, ordered oldest to newest, with time and ID filters to page through up to 500 messages.
Instructions
Read chat history of a channel, thread or DM in readable form (oldest → newest). Paginates up to 500 messages. Use since/before/after/around to move in time.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "read_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Include full embed text, mentions and ids | |
| after | No | Only messages after this message ID | |
| limit | No | How many messages (default 50, max 500) | |
| since | No | Only messages after this time (ISO8601, e.g. 2026-11-20T00:00:00Z) | |
| until | No | Only messages before this time (ISO8601) | |
| around | No | Messages around this message ID | |
| before | No | Only messages before this message ID | |
| user_id | No | Or: a user ID to DM (opens the DM for you) | |
| channel_id | No | Channel/thread/DM ID or a discord.com/channels/… link |