discord-mcp

List webhooks

discord_list_webhooks

Read-only

Toolset
Webhooks webhooks
Discord permission
Manage Webhooks
Context cost
340 tokens, estimated1,361 bytes of definition, divided by 4

List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Provide channel_id or guild_id; when both are given, only channel_id is used. Requires the Manage Webhooks permission. SECURITY: a returned token lets anyone post as that webhook; treat it as a secret. Pass the id and token to discord_send_webhook_message, or create a webhook with discord_create_webhook.

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
channel_idoptionalstring
pattern ^\d{17,20}$
ID (snowflake) of a channel to list webhooks for. Takes precedence over guild_id.
guild_idoptionalstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake) to list all webhooks for. Ignored when channel_id is given.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
webhooksrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring or null
channel_id (nested, level 1)requiredstring
token (nested, level 1)requiredstring or null
creator (nested, level 1)requiredstring or null

Related tools

Named in its description

Also in Webhooks

Raw definition (1,361 bytes)
{
  "name": "discord_list_webhooks",
  "description": "List the webhooks in a single channel or across a whole server (id, name, channel, token when visible, creator). Provide channel_id or guild_id; when both are given, only channel_id is used. Requires the Manage Webhooks permission. SECURITY: a returned token lets anyone post as that webhook; treat it as a secret. Pass the id and token to discord_send_webhook_message, or create a webhook with discord_create_webhook.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "description": "ID (snowflake) of a channel to list webhooks for. Takes precedence over guild_id.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      },
      "guild_id": {
        "description": "Discord server (guild) ID (snowflake) to list all webhooks for. Ignored when channel_id is given.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "webhooks": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "channel_id": {
              "type": "string"
            },
            "token": {
              "type": [
                "string",
                "null"
              ]
            },
            "creator": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "channel_id",
            "token",
            "creator"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "webhooks"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List webhooks",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}