GnistAI GnistAI
Log in

Recipe Database

International recipe collection — search by name, browse by category or cuisine, get random recipes.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 7 tools tools 7 7 Food & Drink

Data source: TheMealDB

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/recipe/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-recipe": {
      "url": "https://context.gnist.ai/mcp/recipe/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/recipe/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_recipes", "arguments": {"query": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/recipe/

7 endpoints available:

Shell
curl "https://context.gnist.ai/rest/recipe/search_recipes?query=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/recipe/search_recipes",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "query": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc recipe

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (7)

search_recipes
Search international recipes by name.
ParameterTypeRequiredDescription
querystringrequiredRecipe name to search for (e.g. "Arrabiata", "chicken", "pasta").
get_recipe
Get full details for a specific recipe by its ID.
ParameterTypeRequiredDescription
meal_idstringrequiredTheMealDB recipe ID (e.g. "52771").
get_random_recipe
Get a random recipe from the international recipe database.
list_categories
List all available recipe categories (e.g. Beef, Chicken, Dessert, Seafood).
filter_by_category
Filter recipes by category. Returns recipe summaries (name, ID, image).
ParameterTypeRequiredDescription
categorystringrequiredRecipe category (e.g. "Beef", "Chicken", "Dessert", "Seafood", "Vegetarian").
filter_by_area
Filter recipes by cuisine/area. Returns recipe summaries (name, ID, image).
ParameterTypeRequiredDescription
areastringrequiredCuisine area (e.g. "Italian", "Japanese", "Mexican", "British", "Indian").
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related