Get forum post
discord_
Read-only
- Toolset
- Forums
forums - Discord permissions
- View Channel and Read Message History
- Context cost
- 534 tokens, estimated2,135 bytes of definition, divided by 4
Get a forum post's details (title, archived/locked state, applied tags, message count) plus its recent messages, oldest-to-newest. Read-only. Pass the post's thread_id. Requires the View Channel and Read Message History permissions on the forum; without Read Message History an empty message list fails with an error naming the permission. Returns a JSON object.
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 |
|---|---|---|---|
| thread_ | string | pattern ^\d{17,20}$ | ID (snowflake) of the forum post (thread). |
| limitoptional | integer | 1 to 100default 20 | How many recent messages to include (1–100). Default 20. |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type | Description |
|---|---|---|
| idrequired | string | |
| namerequired | string | |
| archivedrequired | boolean or null | |
| lockedrequired | boolean or null | |
| messageCountrequired | number or null | |
| appliedTagsrequired | array of strings | |
| createdAtrequired | string or null | |
| messagesrequired | array of objects | |
| id (nested, level 1)required | string | |
| author (nested, level 1)required | string | |
| author_ | string | |
| webhook_ | string | |
| content (nested, level 1)required | string | |
| timestamp (nested, level 1)required | string | |
| embeds (nested, level 1) | array of objects | |
| title (nested, level 2) | string | |
| author (nested, level 2) | string | |
| description (nested, level 2) | string | |
| url (nested, level 2) | string | |
| fields (nested, level 2) | array of objects | |
| name (nested, level 3)required | string | |
| value (nested, level 3)required | string | |
| moreFields (nested, level 2) | number | Count of fields left out past the first 10. Absent when none were. |
| footer (nested, level 2) | string |
Related tools
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 -
List forum threads, Read-only
discord_list_ forum_ threads -
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,135 bytes)
{
"name": "discord_get_forum_post",
"description": "Get a forum post's details (title, archived/locked state, applied tags, message count) plus its recent messages, oldest-to-newest. Read-only. Pass the post's thread_id. Requires the View Channel and Read Message History permissions on the forum; without Read Message History an empty message list fails with an error naming the permission. Returns a JSON object.",
"inputSchema": {
"type": "object",
"properties": {
"thread_id": {
"type": "string",
"pattern": "^\\d{17,20}$",
"description": "ID (snowflake) of the forum post (thread)."
},
"limit": {
"default": 20,
"description": "How many recent messages to include (1–100). Default 20.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"thread_id"
],
"additionalProperties": false
},
"outputSchema": {
"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"
]
},
"messages": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"author": {
"type": "string"
},
"author_id": {
"type": "string"
},
"webhook_id": {
"type": "string"
},
"content": {
"type": "string"
},
"timestamp": {
"type": "string"
},
"embeds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"description": {
"type": "string"
},
"url": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
},
"moreFields": {
"description": "Count of fields left out past the first 10. Absent when none were.",
"type": "number"
},
"footer": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"required": [
"id",
"author",
"author_id",
"content",
"timestamp"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"name",
"archived",
"locked",
"messageCount",
"appliedTags",
"createdAt",
"messages"
],
"additionalProperties": false
},
"annotations": {
"title": "Get forum post",
"readOnlyHint": true,
"openWorldHint": true
}
}