discord-mcp

Get forum post

discord_get_forum_post

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-onlyreadOnlyHintyesDoes not modify your server.
DestructivedestructiveHintn/aNot declared: it only applies to tools that write.
IdempotentidempotentHintn/aNot declared.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
thread_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the forum post (thread).
limitoptionalinteger
1 to 100default 20
How many recent messages to include (1–100). Default 20.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldTypeDescription
idrequiredstring
namerequiredstring
archivedrequiredboolean or null
lockedrequiredboolean or null
messageCountrequirednumber or null
appliedTagsrequiredarray of strings
createdAtrequiredstring or null
messagesrequiredarray of objects
id (nested, level 1)requiredstring
author (nested, level 1)requiredstring
author_id (nested, level 1)requiredstring
webhook_id (nested, level 1)string
content (nested, level 1)requiredstring
timestamp (nested, level 1)requiredstring
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)requiredstring
value (nested, level 3)requiredstring
moreFields (nested, level 2)numberCount of fields left out past the first 10. Absent when none were.
footer (nested, level 2)string

Related tools

Also in Forums

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
  }
}