discord-mcp

Edit scheduled event

discord_edit_scheduled_event

Write

Toolset
Scheduled events scheduled_events
Discord permission
Manage Events
Context cost
651 tokens, estimated2,603 bytes of definition, divided by 4

Update a scheduled event; only provided fields change. Use the status field to start ('ACTIVE'), end ('COMPLETED'), or cancel ('CANCELED') an event; Discord only allows certain status transitions. Discord rejects a location on VOICE and STAGE_INSTANCE events. An ACTIVE voice or stage event ends on its own a few minutes after its channel empties. Requires the Manage Events permission, or Create Events for an event the bot created, plus the same channel permissions as creating it.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintyesRepeating the call with the same arguments has no additional effect.
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 event to edit.
nameoptionalstring
none
New event name (max 100 characters).
descriptionoptionalstring
none
New event description (max 1000 characters).
scheduled_start_timeoptionalstring
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)))$
New start time as an ISO 8601 datetime.
scheduled_end_timeoptionalstring
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)))$
New end time as an ISO 8601 datetime.
channel_idoptionalstring
pattern ^\d{17,20}$
New voice/stage channel ID (snowflake) for VOICE/STAGE_INSTANCE events.
locationoptionalstring
none
New free-text location for EXTERNAL events.
imageoptionalstring
format uripattern ^https?://
New cover image URL.
statusoptionalstring
one of "ACTIVE""COMPLETED""CANCELED"
Change event status. Allowed transitions only: SCHEDULED→ACTIVE→COMPLETED, or SCHEDULED→CANCELED (no transition back to SCHEDULED exists).

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Also in Scheduled events

Raw definition (2,603 bytes)
{
  "name": "discord_edit_scheduled_event",
  "description": "Update a scheduled event; only provided fields change. Use the status field to start ('ACTIVE'), end ('COMPLETED'), or cancel ('CANCELED') an event; Discord only allows certain status transitions. Discord rejects a location on VOICE and STAGE_INSTANCE events. An ACTIVE voice or stage event ends on its own a few minutes after its channel empties. Requires the Manage Events permission, or Create Events for an event the bot created, plus the same channel permissions as creating it.",
  "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 event to edit."
      },
      "name": {
        "description": "New event name (max 100 characters).",
        "type": "string"
      },
      "description": {
        "description": "New event description (max 1000 characters).",
        "type": "string"
      },
      "scheduled_start_time": {
        "description": "New start time as an ISO 8601 datetime.",
        "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)))$"
      },
      "scheduled_end_time": {
        "description": "New end time as an ISO 8601 datetime.",
        "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)))$"
      },
      "channel_id": {
        "description": "New voice/stage channel ID (snowflake) for VOICE/STAGE_INSTANCE events.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      },
      "location": {
        "description": "New free-text location for EXTERNAL events.",
        "type": "string"
      },
      "image": {
        "description": "New cover image URL.",
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      },
      "status": {
        "description": "Change event status. Allowed transitions only: SCHEDULED→ACTIVE→COMPLETED, or SCHEDULED→CANCELED (no transition back to SCHEDULED exists).",
        "type": "string",
        "enum": [
          "ACTIVE",
          "COMPLETED",
          "CANCELED"
        ]
      }
    },
    "required": [
      "guild_id",
      "event_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Edit scheduled event",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true
  }
}