discord-mcp

List channel invites

discord_list_channel_invites

Read-only

Toolset
Invites invites
Discord permission
Manage Channels
Context cost
375 tokens, estimated1,498 bytes of definition, divided by 4

List the active invites that point to one specific channel. Unlike discord_list_invites (server-wide), this scopes results to a single channel. Requires the Manage Channels permission. Read-only.

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_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel to list invites for.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
invitesrequiredarray of objects
code (nested, level 1)requiredstring
url (nested, level 1)requiredstring
guild_id (nested, level 1)requiredstring or null
guild_name (nested, level 1)requiredstring or null
channel_id (nested, level 1)requiredstring or null
channel_name (nested, level 1)requiredstring or null
inviter (nested, level 1)requiredobject or null
id (nested, level 2)requiredstring
username (nested, level 2)requiredstring
uses (nested, level 1)requirednumber
max_uses (nested, level 1)requirednumber
max_age (nested, level 1)requirednumber
temporary (nested, level 1)requiredboolean
created_at (nested, level 1)requiredstring or null
expires_at (nested, level 1)requiredstring or null

Related tools

Named in its description

Also in Invites

Raw definition (1,498 bytes)
{
  "name": "discord_list_channel_invites",
  "description": "List the active invites that point to one specific channel. Unlike discord_list_invites (server-wide), this scopes results to a single channel. Requires the Manage Channels permission. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel to list invites for."
      }
    },
    "required": [
      "channel_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "invites": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "guild_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "guild_name": {
              "type": [
                "string",
                "null"
              ]
            },
            "channel_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "channel_name": {
              "type": [
                "string",
                "null"
              ]
            },
            "inviter": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "username": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "username"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "uses": {
              "type": "number"
            },
            "max_uses": {
              "type": "number"
            },
            "max_age": {
              "type": "number"
            },
            "temporary": {
              "type": "boolean"
            },
            "created_at": {
              "type": [
                "string",
                "null"
              ]
            },
            "expires_at": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "code",
            "url",
            "guild_id",
            "guild_name",
            "channel_id",
            "channel_name",
            "inviter",
            "uses",
            "max_uses",
            "max_age",
            "temporary",
            "created_at",
            "expires_at"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "invites"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List channel invites",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}