{"openapi":"3.0.3","info":{"title":"Gnist Context — Recipe Database","description":"International recipe collection — search by name, browse by category or cuisine, get random recipes.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/recipe/`\n- **Toolkit page:** `/toolkits/recipe`\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/recipe/search_recipes":{"post":{"tags":["Food & Drink"],"summary":"search_recipes","description":"Search international recipes by name.\n\nReturns full recipe details including ingredients, instructions, and category.\n\nArgs:\n    query: Recipe name to search for (e.g. \"Arrabiata\", \"chicken\", \"pasta\").","operationId":"recipe_search_recipes","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":"Recipe name to search for (e.g. \"Arrabiata\", \"chicken\", \"pasta\").","type":"string"}},"required":["query"],"type":"object"}}}}}},"/rest/recipe/get_recipe":{"post":{"tags":["Food & Drink"],"summary":"get_recipe","description":"Get full details for a specific recipe by its ID.\n\nArgs:\n    meal_id: TheMealDB recipe ID (e.g. \"52771\").\n\nReturns:\n    Full recipe record with ingredients, instructions, category, and cuisine.","operationId":"recipe_get_recipe","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":{"meal_id":{"description":"TheMealDB recipe ID (e.g. \"52771\").","type":"string"}},"required":["meal_id"],"type":"object"}}}}}},"/rest/recipe/get_random_recipe":{"post":{"tags":["Food & Drink"],"summary":"get_random_recipe","description":"Get a random recipe from the international recipe database.\n\nReturns:\n    A randomly selected recipe with full details.","operationId":"recipe_get_random_recipe","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/recipe/list_categories":{"post":{"tags":["Food & Drink"],"summary":"list_categories","description":"List all available recipe categories (e.g. Beef, Chicken, Dessert, Seafood).\n\nReturns:\n    List of categories with names, thumbnails, and descriptions.","operationId":"recipe_list_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/recipe/filter_by_category":{"post":{"tags":["Food & Drink"],"summary":"filter_by_category","description":"Filter recipes by category. Returns recipe summaries (name, ID, image).\n\nUse get_recipe() with the returned ID to get full details.\n\nArgs:\n    category: Recipe category (e.g. \"Beef\", \"Chicken\", \"Dessert\", \"Seafood\", \"Vegetarian\").","operationId":"recipe_filter_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":"Recipe category (e.g. \"Beef\", \"Chicken\", \"Dessert\", \"Seafood\", \"Vegetarian\").","type":"string"}},"required":["category"],"type":"object"}}}}}},"/rest/recipe/filter_by_area":{"post":{"tags":["Food & Drink"],"summary":"filter_by_area","description":"Filter recipes by cuisine/area. Returns recipe summaries (name, ID, image).\n\nUse get_recipe() with the returned ID to get full details.\n\nArgs:\n    area: Cuisine area (e.g. \"Italian\", \"Japanese\", \"Mexican\", \"British\", \"Indian\").","operationId":"recipe_filter_by_area","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":{"area":{"description":"Cuisine area (e.g. \"Italian\", \"Japanese\", \"Mexican\", \"British\", \"Indian\").","type":"string"}},"required":["area"],"type":"object"}}}}}},"/rest/recipe/report_feedback":{"post":{"tags":["Food & Drink"],"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":"recipe_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":"Food & Drink","description":"Data sources: Food & Drink"}],"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."}}}}