Food & Drink
Data source: TheMealDB
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"}}}'
REST API
API Root
https://context.gnist.ai/rest/recipe/
7 endpoints available:
GET /rest/recipe/search_recipesGET /rest/recipe/get_recipeGET /rest/recipe/get_random_recipeGET /rest/recipe/list_categoriesGET /rest/recipe/filter_by_categoryGET /rest/recipe/filter_by_areaGET /rest/recipe/report_feedback
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())
Command Line
Command
gc recipe
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (7)
search_recipesSearch international recipes by name.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Recipe name to search for (e.g. "Arrabiata", "chicken", "pasta"). |
get_recipeGet full details for a specific recipe by its ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
meal_id | string | required | TheMealDB recipe ID (e.g. "52771"). |
get_random_recipeGet a random recipe from the international recipe database.
list_categoriesList all available recipe categories (e.g. Beef, Chicken, Dessert, Seafood).
filter_by_categoryFilter recipes by category. Returns recipe summaries (name, ID, image).
| Parameter | Type | Required | Description |
|---|---|---|---|
category | string | required | Recipe category (e.g. "Beef", "Chicken", "Dessert", "Seafood", "Vegetarian"). |
filter_by_areaFilter recipes by cuisine/area. Returns recipe summaries (name, ID, image).
| Parameter | Type | Required | Description |
|---|---|---|---|
area | string | required | Cuisine area (e.g. "Italian", "Japanese", "Mexican", "British", "Indian"). |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |