Diets Premium Diets Premium
Sign in
Katalog Narzędzi MCP & Endpointów REST API
Widgety: Specyfikacja Tabela argumentów Terminal & Odpowiedź Task & Subagent Kafelki narzędzi
Back to MCP Tools Catalog search_food JSON-RPC 2.0 • tools/call
POST /api/v1/food

Nutritional Database & Macro Search

Core food and nutrition search tool for AI agents. Retrieve exact protein, fat, carb, and calorie breakdown per 100g with micronutrient densities and allergen exclusion criteria.

Nazwa narzędzia MCP search_food
Endpoint HTTP / Stream https://www.dietspremium.com/_mcp/search/food
Mostek CLI (stdio) npx -y dietspremium-mcp
Kontrakt Wejściowy (JSON Schema)

Input Parameters Schema (inputSchema)

8 Field name
Field name JSON Type Status Description Example value
query string Required Food item (e.g. "grilled chicken breast", "avocado") —
locale string Optional Language locale en
proteins_min / proteins_max integer Optional Protein range in grams 0
kcal_min / kcal_max integer Optional Calorie range per 100g 0
allergen_exclude string Optional Comma-separated allergens to exclude —
food_nutrient_include string Optional Required nutrient (e.g. "iron", "calcium") —
page integer Optional Page number (10 results per page) 1
ai boolean Optional AI semantic vector search true

JSON-RPC 2.0 Request (tools/call)

search_food
terminal — tools/call search_food
JSON-RPC 2.0 REQUEST
npx -y dietspremium-mcp --url https://www.dietspremium.com/_mcp 
curl -X POST https://www.dietspremium.com/_mcp/search/food \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_MCP_KEY" \
  -d '{
  "query": "chicken breast",
  "locale": "en",
  "proteins_min": 25,
  "kcal_max": 250,
  "allergen_exclude": "gluten,lactose",
  "page": 1,
  "max_results": 5,
  "ai": true
}'

MCP Tool Response Structure

application/json • UTF-8
response — search_food (JSON-RPC 2.0)
MCP Response 200 OK 
{
  "content": [
    {
      "type": "text",
      "text": "Food: Chicken Breast Raw (key: MTQ=, 100g) - Calories: 165 kcal, Protein: 31.0g, Fat: 3.6g, Carbs: 0.0g. Allergens: None."
    }
  ]
}
Kroki wykonania dla search_food MCP Flow

Instrukcja integracji dla programistów i agentów AI
1
Walidacja argumentów wejściowych (search_food) search_food

Przekaż parametry zgodne z tabelą obok (np. locale="en").

2
Odczyt wyniku i klucza Base64 (key) McpKeyCodec

Każdy zwrócony rekord posiada pole "key" (Base64), które można bezpiecznie przekazać do narzędzi management_*.

Subagent_food Ready

Specjalizowany Agent dla narzędzia search_food

MCP v2.0 Tool Runner
Prompt Wejściowy Agenta AI

“Wykonaj zapytanie do narzędzia search_food dla języka EN i zwróć ustrukturyzowane dane kliniczne.”

Wykorzystywane Narzędzia MCP / Endpointy
search_food
Ślad Wywołania (Execution Trace) 
→ POST https://www.dietspremium.com/_mcp/search/food (tool: "search_food")
← 200 OK (8 zwalidowanych parametrów)

Other MCP Server Tools

Pełny katalog MCP →
search_allergen Allergen Risk & Intolerance Registry
search_article Clinical Nutrition Guides & RAG Grounding
search_company Dietetic Catering & Clinic Directory
search_exercise Exercise Biomechanics & Calorie Burn
search_medication Pharmacology & Food-Drug Interactions
search_recipe Culinary Recipes & Macro Balancing
search_user Specialists & Certified Dietitians
search_supplement Supplements & Active Dosages
search_diet Clinical & Lifestyle Diet Templates (158 Types)
search_food_world Global Food Products & Barcodes (Open Food Facts + USDA)
search_knowledge Clinical Knowledge & Dietetic Grounding
management_account Account, Profile, GeoName Address (Residential, Delivery, Work), Job, Education & S3 Avatar/Cover
management_calendar Personal & Company Calendar Events Manager
management_company Company, Clinic & Catering Profile Management
management_patient Patient & Client CRM (List, Add, Edit, Soft-Deactivate)
management_diet Diet Builder (Trainer Mode) & Patient Tracking / Fridge Replacement AI
management_training Training Plan Builder (Trainer Mode) & Workout Execution
management_recipe Culinary Recipe Builder & S3 Media Manager
management_food Food Product & Nutrient Catalog Manager
management_supplement Dietary Supplement Catalog Manager
management_medication Medication & Drug-Food Interaction Manager
management_exercise Exercise & Biomechanics Catalog Manager
management_exercise_bundle Exercise Bundle & Circuit Manager
management_allergen Food Allergen Catalog Manager

Share