List invites
discord_
Read-only
- Toolset
- Invites
invites - Context cost
- 409 tokens, estimated1,635 bytes of definition, divided by 4
List all active invites across a server (code, url, channel, inviter, uses, expiry). Requires the Manage Server or View Audit Log permission; without Manage Server or Manage Channels, Discord omits invite metadata, so uses, max_uses and max_age read 0, temporary reads false and created_at null. Read-only. Use discord_ to scope to one channel.
Risk and annotations
Read-onlyreadOnlyHint | yes | Does not modify your server. |
|---|---|---|
DestructivedestructiveHint | n/a | Not declared: it only applies to tools that write. |
IdempotentidempotentHint | n/a | Not declared. |
Open worldopenWorldHint | yes | Interacts with an external system: Discord. |
Annotations are hints the server declares. Clients use them to decide when to ask you before a call.
Parameters
| Parameter | Type | Rules | Description |
|---|---|---|---|
| guild_ | string | pattern ^\d{17,20}$ | Discord server (guild) ID (snowflake). |
Output
Declared by outputSchema: clients receive this shape as structuredContent.
| Field | Type |
|---|---|
| invitesrequired | array of objects |
| code (nested, level 1)required | string |
| url (nested, level 1)required | string |
| guild_ | string or null |
| guild_ | string or null |
| channel_ | string or null |
| channel_ | string or null |
| inviter (nested, level 1)required | object or null |
| id (nested, level 2)required | string |
| username (nested, level 2)required | string |
| uses (nested, level 1)required | number |
| max_ | number |
| max_ | number |
| temporary (nested, level 1)required | boolean |
| created_ | string or null |
| expires_ | string or null |
Related tools
Named in its description
Also in Invites
Raw definition (1,635 bytes)
{
"name": "discord_list_invites",
"description": "List all active invites across a server (code, url, channel, inviter, uses, expiry). Requires the Manage Server or View Audit Log permission; without Manage Server or Manage Channels, Discord omits invite metadata, so uses, max_uses and max_age read 0, temporary reads false and created_at null. Read-only. Use discord_list_channel_invites to scope to one channel.",
"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": {
"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 invites",
"readOnlyHint": true,
"openWorldHint": true
}
}