discord-mcp

Get scheduled event

discord_get_scheduled_event

Read-only

Toolset
Scheduled events scheduled_events
Context cost
385 tokens, estimated1,540 bytes of definition, divided by 4

Get full details for one scheduled event: name, description, status, type, channel/location, start/end times, creator, and interested-user count. Status is SCHEDULED, ACTIVE, COMPLETED or CANCELED, and entity_type is VOICE, STAGE_INSTANCE or EXTERNAL. Find the event_id with discord_list_scheduled_events; list the interested users with discord_get_event_subscribers.

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).
event_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the scheduled event.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
idrequiredstring
namerequiredstring
descriptionrequiredstring or null
statusrequiredstring or number
entity_typerequiredstring or number
channel_idrequiredstring or null
locationrequiredstring or null
scheduled_start_timerequiredstring or null
scheduled_end_timerequiredstring or null
creator_idrequiredstring or null
user_countrequirednumber or null
imagerequiredstring or null

Related tools

Named in its description

Also in Scheduled events

Raw definition (1,540 bytes)
{
  "name": "discord_get_scheduled_event",
  "description": "Get full details for one scheduled event: name, description, status, type, channel/location, start/end times, creator, and interested-user count. Status is SCHEDULED, ACTIVE, COMPLETED or CANCELED, and entity_type is VOICE, STAGE_INSTANCE or EXTERNAL. Find the event_id with discord_list_scheduled_events; list the interested users with discord_get_event_subscribers.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "event_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the scheduled event."
      }
    },
    "required": [
      "guild_id",
      "event_id"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "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
  },
  "annotations": {
    "title": "Get scheduled event",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}