discord-mcp

List forum threads

discord_list_forum_threads

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_get_forum_post to read one post's messages. For threads in a text or announcement channel, use discord_list_channel_threads.

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
forum_channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the forum channel to list posts from.
limitoptionalinteger
2 to 100default 100
Max archived posts per page (2–100). Default 100.
beforeoptionalstring
format date-time
pattern (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.

FieldType
threadsrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
archived (nested, level 1)requiredboolean or null
locked (nested, level 1)requiredboolean or null
messageCount (nested, level 1)requirednumber or null
appliedTags (nested, level 1)requiredarray of strings
createdAt (nested, level 1)requiredstring or null
hasMorerequiredboolean
nextBeforerequiredstring or null

Related tools

Named in its description

Also in Forums

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