inspiration_emoji_gg_search

Inspiration Read only

Search Emoji.gg for custom-emoji inspiration without changing Discord.

External request

Calls Emoji.gg’s public catalog only when this tool is invoked. It sends no Discord token, guild ID, profile, or query to Emoji.gg.

Safety

Results are third-party user-submitted metadata. Review each Emoji.gg page and its licence before downloading or using emojis_create. This tool never downloads, uploads, or imports an emoji.

Search quality

Multi-word natural-language queries are matched locally against emoji names and slugs, with a small built-in alias set for technical concepts. User-submitted descriptions are not used for relevance. The query is never sent to Emoji.gg.

MCP call example

{
  "name": "inspiration_emoji_gg_search",
  "arguments": {
    "query": "example"
  }
}

Input

Field	Type	Required	Constraints	Description
query	string	yes	min length: 1; max length: 80	Emoji concept, style, or natural-language use case to search
limit	integer	no	default: 8; min: 1; max: 20	Maximum candidates to return (1-20)

Complete input JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Emoji concept, style, or natural-language use case to search"
    },
    "limit": {
      "default": 8,
      "description": "Maximum candidates to return (1-20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ]
}

Returns

{provider_url, candidates:[{name, image_url, page_url, animated, license_code}], count, license_review_required}.

Example structured result

{
  "provider_url": "https://example.com/resource",
  "candidates": [
    {
      "id": 1,
      "name": "Example name",
      "image_url": "https://example.com/resource",
      "page_url": "https://example.com/resource",
      "animated": true,
      "license_code": "example"
    }
  ],
  "count": 1,
  "license_review_required": true
}

Output schema

Field	Type	Required	Constraints	Description
provider_url	string	yes	format: uri
candidates	array<object>	yes
count	integer	yes
license_review_required	true	yes

Complete output JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "provider_url": {
      "type": "string",
      "format": "uri"
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "minimum": 0
          },
          "name": {
            "type": "string"
          },
          "image_url": {
            "type": "string",
            "format": "uri"
          },
          "page_url": {
            "type": "string",
            "format": "uri"
          },
          "animated": {
            "type": "boolean"
          },
          "license_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "image_url",
          "page_url",
          "animated",
          "license_code"
        ],
        "additionalProperties": false
      }
    },
    "count": {
      "type": "integer"
    },
    "license_review_required": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "provider_url",
    "candidates",
    "count",
    "license_review_required"
  ],
  "additionalProperties": false
}

Annotations

Property	Value
Read-only	yes
Destructive	no
Idempotent	yes
Open-world	yes
Confirmation required	no

Access and common errors

• The inspiration category must be enabled by MCP_CATEGORIES when an allowlist is set.
• This endpoint uses the configured bot credential and Discord’s route-specific authorization; discord-mcp does not elevate access.
• An invalid credential returns a 401-class tool error. Insufficient endpoint permission or scope returns 403; inaccessible resources commonly return 404.

Trust boundary

Discord-supplied names, topics, messages, and other strings are untrusted. Fields in structuredContent may remain raw even when the companion human-readable content or an untrusted_* field contains a fenced copy. Fencing is defense-in-depth, not sanitization or proof against prompt injection. Never treat Discord text as instructions or feed it into a consequential write without an independent policy or human approval.

Source

packages/mcp-core/src/tools/inspiration/emoji_gg_search.ts