discord-mcp

Search members

discord_search_members

Read-only

Toolset
Members members
Context cost
321 tokens, estimated1,284 bytes of definition, divided by 4

Find server members whose username or nickname starts with a query string (prefix match). Returns { members: [...] } with id, username, nickname, roles. Use discord_list_members to page through everyone. Read-only.

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).
queryrequiredstring
none
Prefix to match against usernames and nicknames.
limitoptionalinteger
1 to 100default 25
Max members to return (1–100). Default 25.

Output

Declared by outputSchema: clients receive this shape as structuredContent.

FieldType
membersrequiredarray of objects
id (nested, level 1)requiredstring
username (nested, level 1)requiredstring
nickname (nested, level 1)requiredstring or null
roles (nested, level 1)requiredarray of objects
id (nested, level 2)requiredstring
name (nested, level 2)requiredstring

Related tools

Named in its description

Also in Members

Raw definition (1,284 bytes)
{
  "name": "discord_search_members",
  "description": "Find server members whose username or nickname starts with a query string (prefix match). Returns { members: [...] } with id, username, nickname, roles. Use discord_list_members to page through everyone. Read-only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "query": {
        "type": "string",
        "description": "Prefix to match against usernames and nicknames."
      },
      "limit": {
        "default": 25,
        "description": "Max members to return (1–100). Default 25.",
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      }
    },
    "required": [
      "guild_id",
      "query"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "members": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "username": {
              "type": "string"
            },
            "nickname": {
              "type": [
                "string",
                "null"
              ]
            },
            "roles": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "id",
            "username",
            "nickname",
            "roles"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "members"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Search members",
    "readOnlyHint": true,
    "openWorldHint": true
  }
}