discord-mcp

List scheduled events

discord_list_scheduled_events

Read-only

Toolset
Scheduled events scheduled_events
Context cost
336 tokens, estimated1,345 bytes of definition, divided by 4

List all scheduled events in a server (id, name, status, type, time, location, interested count). Read-only. Use discord_get_scheduled_event for one event's full details.

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
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake).

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
eventsrequiredarray of objects
id (nested, level 1)requiredstring
name (nested, level 1)requiredstring
description (nested, level 1)requiredstring or null
status (nested, level 1)requiredstring or number
entity_type (nested, level 1)requiredstring or number
channel_id (nested, level 1)requiredstring or null
location (nested, level 1)requiredstring or null
scheduled_start_time (nested, level 1)requiredstring or null
scheduled_end_time (nested, level 1)requiredstring or null
creator_id (nested, level 1)requiredstring or null
user_count (nested, level 1)requirednumber or null
image (nested, level 1)requiredstring or null

Related tools

Named in its description

Also in Scheduled events

Raw definition (1,345 bytes)
{
  "name": "discord_list_scheduled_events",
  "description": "List all scheduled events in a server (id, name, status, type, time, location, interested count). Read-only. Use discord_get_scheduled_event for one event's full details.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      }
    },
    "required": [
      "guild_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "events": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            },
            "description": {
              "type": [
                "string",
                "null"
              ]
            },
            "status": {
              "type": [
                "string",
                "number"
              ]
            },
            "entity_type": {
              "type": [
                "string",
                "number"
              ]
            },
            "channel_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            },
            "scheduled_start_time": {
              "type": [
                "string",
                "null"
              ]
            },
            "scheduled_end_time": {
              "type": [
                "string",
                "null"
              ]
            },
            "creator_id": {
              "type": [
                "string",
                "null"
              ]
            },
            "user_count": {
              "type": [
                "number",
                "null"
              ]
            },
            "image": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "description",
            "status",
            "entity_type",
            "channel_id",
            "location",
            "scheduled_start_time",
            "scheduled_end_time",
            "creator_id",
            "user_count",
            "image"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "events"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "List scheduled events",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}