{"openapi":"3.0.3","info":{"title":"Gnist Context — Riddles & Puzzles","description":"Curated riddle and brain teaser database with 80 riddles across 5 categories (logic, wordplay, math, lateral-thinking, classic) — get random riddles, search, and reveal answers.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/riddles/`\n- **Toolkit page:** `/toolkits/riddles`\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/riddles/get_random_riddle":{"post":{"tags":["Entertainment"],"summary":"get_random_riddle","description":"Get a random riddle WITHOUT the answer.\n\nReturns a brain teaser with question and hint. Use get_riddle_answer() with the riddle ID to reveal the answer.\nOptionally filter by category and/or difficulty.","operationId":"riddles_get_random_riddle","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":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by category (logic, wordplay, math, lateral-thinking, classic). Omit for any."},"difficulty":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by difficulty (easy, medium, hard). Omit for any."}},"type":"object"}}}}}},"/rest/riddles/get_riddle_answer":{"post":{"tags":["Entertainment"],"summary":"get_riddle_answer","description":"Reveal the answer to a specific riddle.\n\nTakes a riddle ID (from get_random_riddle or search_riddles) and returns the full riddle including the answer.","operationId":"riddles_get_riddle_answer","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":{"riddle_id":{"description":"The ID of the riddle to reveal the answer for.","type":"integer"}},"required":["riddle_id"],"type":"object"}}}}}},"/rest/riddles/search_riddles":{"post":{"tags":["Entertainment"],"summary":"search_riddles","description":"Search for riddles by keyword.\n\nSearches across question text, hints, and categories. Case-insensitive. Results do NOT include answers.","operationId":"riddles_search_riddles","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 keyword — matches question, hint, or category.","type":"string"},"max_results":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Maximum number of results (default: 20, max: 100)."}},"required":["query"],"type":"object"}}}}}},"/rest/riddles/list_riddle_categories":{"post":{"tags":["Entertainment"],"summary":"list_riddle_categories","description":"List all available riddle categories.\n\nReturns the category names that can be used to filter random riddles.","operationId":"riddles_list_riddle_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/riddles/report_feedback":{"post":{"tags":["Entertainment"],"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":"riddles_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":"Entertainment","description":"Data sources: Entertainment"}],"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."}}}}