discord-mcp

Create event invite

discord_create_event_invite

Write

Toolset
Scheduled events scheduled_events
Discord permission
Create Instant Invite
Context cost
413 tokens, estimated1,651 bytes of definition, divided by 4

Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Requires the Create Instant Invite permission. Returns the invite URL; Discord may reuse a similar existing invite instead of creating a new one. EXTERNAL events need channel_id; other events reject it and use their own channel. The URL is an ordinary channel invite with ?event=<event ID> appended. Use discord_create_invite for a channel invite with the unique or temporary options.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
IdempotentidempotentHintnoRepeating the call can have an 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 scheduled event to link the invite to.
channel_idoptionalstring
pattern ^\d{17,20}$
Channel (snowflake) the invite points to. Required for EXTERNAL events, which have no channel of their own. Omit it for VOICE and STAGE_INSTANCE events: they always use their own channel, and passing one fails.
max_ageoptionalinteger
0 to 604800default 86400
Invite lifetime in seconds, 0–604800 (7 days); 0 means it never expires. Default 86400 (24h).
max_usesoptionalinteger
0 to 100default 0
Maximum number of uses, 0–100; 0 means unlimited. Default 0.

Output

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

Related tools

Named in its description

Also in Scheduled events

Raw definition (1,651 bytes)
{
  "name": "discord_create_event_invite",
  "description": "Create a shareable invite URL that points to a scheduled event, so recipients land on the event when joining. Requires the Create Instant Invite permission. Returns the invite URL; Discord may reuse a similar existing invite instead of creating a new one. EXTERNAL events need channel_id; other events reject it and use their own channel. The URL is an ordinary channel invite with ?event=<event ID> appended. Use discord_create_invite for a channel invite with the unique or temporary options.",
  "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 to link the invite to."
      },
      "channel_id": {
        "description": "Channel (snowflake) the invite points to. Required for EXTERNAL events, which have no channel of their own. Omit it for VOICE and STAGE_INSTANCE events: they always use their own channel, and passing one fails.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      },
      "max_age": {
        "default": 86400,
        "description": "Invite lifetime in seconds, 0–604800 (7 days); 0 means it never expires. Default 86400 (24h).",
        "type": "integer",
        "minimum": 0,
        "maximum": 604800
      },
      "max_uses": {
        "default": 0,
        "description": "Maximum number of uses, 0–100; 0 means unlimited. Default 0.",
        "type": "integer",
        "minimum": 0,
        "maximum": 100
      }
    },
    "required": [
      "guild_id",
      "event_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create event invite",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}