List channel threads
discord_
Read-only
- Toolset
- Messages
messages - Discord permissions
- View Channel and Read Message History
- Context cost
- 627 tokens, estimated2,508 bytes of definition, divided by 4
List the threads in a text or announcement channel. Returns { threads: [...], hasMore, nextBefore }. The first call includes active threads plus the first page of archived ones; while hasMore is true pass nextBefore back as `before`. hasMore means that page came back full, so the last call can return nothing. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Requires the View Channel and Read Message History permissions. Read-only. Use discord_ for a forum's posts.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| channel_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the text or announcement channel to list threads from. |
| limitoptional | integer | 2 to 100default 100 | Max archived threads per page (2–100). Default 100. |
| typeoptional | string | one of "public""private"default "public" | Which archived threads to page through. Private requires the Manage Threads permission. Active threads are returned either way. Default public. |
| beforeoptional | string | format date-timepattern (288 characters)^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | Pagination cursor: an ISO timestamp compared against when a thread was archived. Pass the previous response's nextBefore to fetch older archived threads. When set, active threads are omitted. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| threadsrequired | array of objects |
| id (nested, level 1)required | string |
| name (nested, level 1)required | string |
| private (nested, level 1)required | boolean |
| archived (nested, level 1)required | boolean or null |
| locked (nested, level 1)required | boolean or null |
| messageCount (nested, level 1)required | number or null |
| createdAt (nested, level 1)required | string or null |
| hasMorerequired | boolean |
| nextBeforerequired | string or null |
Related tools
Named in its description
Also in Messages
-
Read messages, Read-only
discord_read_ messages -
Send message, Write
discord_send_ message -
Reply to message, Write
discord_reply_ message -
Edit message, Write
discord_edit_ message -
Add reaction, Write
discord_add_ reaction -
Create thread, Write
discord_create_ thread -
Bulk delete messages, Destructive
discord_bulk_ delete_ messages -
Send embed, Write
discord_send_ embed -
Edit embed, Write
discord_edit_ embed -
Send multiple embeds, Write
discord_send_ multiple_ embeds -
Delete message, Destructive
discord_delete_ message -
Pin or unpin message, Write
discord_pin_ message -
Search messages, Read-only
discord_search_ messages -
Search guild messages, Read-only
discord_search_ guild_ messages -
Crosspost message, Write
discord_crosspost_ message -
Remove reactions, Destructive
discord_remove_ reactions -
Get reactions, Read-only
discord_get_ reactions -
Get message attachments, Read-only
discord_get_ message_ attachments -
Fetch pinned messages, Read-only
discord_fetch_ pinned_ messages -
Forward message, Write
discord_forward_ message
Raw definition (2,508 bytes)
{
"name": "discord_list_channel_threads",
"description": "List the threads in a text or announcement channel. Returns { threads: [...], hasMore, nextBefore }. The first call includes active threads plus the first page of archived ones; while hasMore is true pass nextBefore back as `before`. hasMore means that page came back full, so the last call can return nothing. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Requires the View Channel and Read Message History permissions. Read-only. Use discord_list_forum_threads for a forum's posts.",
"inputSchema": {
"type": "object",
"properties": {
"channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the text or announcement channel to list threads from."
},
"limit": {
"default": 100,
"description": "Max archived threads per page (2–100). Default 100.",
"type": "integer",
"minimum": 2,
"maximum": 100
},
"type": {
"default": "public",
"description": "Which archived threads to page through. Private requires the Manage Threads permission. Active threads are returned either way. Default public.",
"type": "string",
"enum": [
"public",
"private"
]
},
"before": {
"description": "Pagination cursor: an ISO timestamp compared against when a thread was archived. Pass the previous response's nextBefore to fetch older archived threads. When set, active threads are omitted.",
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
},
"required": [
"channel_id"
],
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"threads": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"private": {
"type": "boolean"
},
"archived": {
"type": [
"boolean",
"null"
]
},
"locked": {
"type": [
"boolean",
"null"
]
},
"messageCount": {
"type": [
"number",
"null"
]
},
"createdAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"private",
"archived",
"locked",
"messageCount",
"createdAt"
],
"additionalProperties": false
}
},
"hasMore": {
"type": "boolean"
},
"nextBefore": {
"type": [
"string",
"null"
]
}
},
"required": [
"threads",
"hasMore",
"nextBefore"
],
"additionalProperties": false
},
"annotations": {
"title": "List channel threads",
"readOnlyHint": true,
"openWorldHint": true
}
}