List forum threads
discord_
Read-only
- Toolset
- Forums
forums - Context cost
- 560 tokens, estimated2,238 bytes of definition, divided by 4
List posts in a forum channel. Returns { threads: [...], hasMore, nextBefore }. The first call (no `before`) includes all active posts plus the first page of archived posts; archived posts are paginated, so if hasMore is true pass nextBefore back as `before` to fetch older archived posts. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Use discord_ to read one post's messages. For threads in a text or announcement channel, use discord_.
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 |
|---|---|---|---|
| forum_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the forum channel to list posts from. |
| limitoptional | integer | 2 to 100default 100 | Max archived posts per page (2–100). Default 100. |
| 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. Pass the previous response's nextBefore to fetch older archived posts. When set, active posts 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 |
| archived (nested, level 1)required | boolean or null |
| locked (nested, level 1)required | boolean or null |
| messageCount (nested, level 1)required | number or null |
| appliedTags (nested, level 1)required | array of strings |
| createdAt (nested, level 1)required | string or null |
| hasMorerequired | boolean |
| nextBeforerequired | string or null |
Related tools
Named in its description
-
Get forum post, Read-only
discord_get_ forum_ post -
List channel threads, Read-only
discord_list_ channel_ threads
Also in Forums
-
List forum channels, Read-only
discord_get_ forum_ channels -
Create forum channel, Write
discord_create_ forum_ channel -
Create forum post, Write
discord_create_ forum_ post -
Reply to forum post, Write
discord_reply_ to_ forum -
Delete forum post, Destructive
discord_delete_ forum_ post -
Get forum tags, Read-only
discord_get_ forum_ tags -
Set forum tags, Destructive
discord_set_ forum_ tags -
Update forum post, Write
discord_update_ forum_ post
Raw definition (2,238 bytes)
{
"name": "discord_list_forum_threads",
"description": "List posts in a forum channel. Returns { threads: [...], hasMore, nextBefore }. The first call (no `before`) includes all active posts plus the first page of archived posts; archived posts are paginated, so if hasMore is true pass nextBefore back as `before` to fetch older archived posts. messageCount excludes the starter message and deleted messages, and is inaccurate above 50 for threads created before July 1, 2022. Use discord_get_forum_post to read one post's messages. For threads in a text or announcement channel, use discord_list_channel_threads.",
"inputSchema": {
"type": "object",
"properties": {
"forum_channel_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the forum channel to list posts from."
},
"limit": {
"default": 100,
"description": "Max archived posts per page (2–100). Default 100.",
"type": "integer",
"minimum": 2,
"maximum": 100
},
"before": {
"description": "Pagination cursor: an ISO timestamp. Pass the previous response's nextBefore to fetch older archived posts. When set, active posts 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": [
"forum_channel_id"
],
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"threads": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"archived": {
"type": [
"boolean",
"null"
]
},
"locked": {
"type": [
"boolean",
"null"
]
},
"messageCount": {
"type": [
"number",
"null"
]
},
"appliedTags": {
"type": "array",
"items": {
"type": "string"
}
},
"createdAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"archived",
"locked",
"messageCount",
"appliedTags",
"createdAt"
],
"additionalProperties": false
}
},
"hasMore": {
"type": "boolean"
},
"nextBefore": {
"type": [
"string",
"null"
]
}
},
"required": [
"threads",
"hasMore",
"nextBefore"
],
"additionalProperties": false
},
"annotations": {
"title": "List forum threads",
"readOnlyHint": true,
"openWorldHint": true
}
}