{"openapi":"3.0.3","info":{"title":"Gnist Context — Emoji Database","description":"Emoji lookup — search by name, keyword, or shortcode, browse by category.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/emoji-database/`\n- **Toolkit page:** `/toolkits/emoji-database`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/emoji-database/get_emoji":{"post":{"tags":["Utilities"],"summary":"get_emoji","description":"Get detailed information about an emoji.\n\nReturns the emoji character, name, category, subcategory, codepoint, shortcodes, keywords, and Unicode version.","operationId":"emoji_database_get_emoji","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"emoji_id":{"description":"Emoji ID slug (e.g. grinning-face, red-heart, thumbs-up).","type":"string"}},"required":["emoji_id"],"type":"object"}}}}}},"/rest/emoji-database/search_emojis":{"post":{"tags":["Utilities"],"summary":"search_emojis","description":"Search the emoji database.","operationId":"emoji_database_search_emojis","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search by name, keyword, or shortcode.","type":"string"},"limit":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/emoji-database/list_emojis_by_category":{"post":{"tags":["Utilities"],"summary":"list_emojis_by_category","description":"List emojis by category.","operationId":"emoji_database_list_emojis_by_category","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"description":"Emoji category (e.g. Smileys & Emotion, People & Body, Flags).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["category"],"type":"object"}}}}}},"/rest/emoji-database/get_emoji_categories":{"post":{"tags":["Utilities"],"summary":"get_emoji_categories","description":"List all emoji categories in the database.","operationId":"emoji_database_get_emoji_categories","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/emoji-database/get_random_emoji":{"post":{"tags":["Utilities"],"summary":"get_random_emoji","description":"Get a random emoji from the database.","operationId":"emoji_database_get_random_emoji","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/emoji-database/report_feedback":{"post":{"tags":["Utilities"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"emoji_database_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Utilities","description":"Data sources: Utilities"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}