Diets Premium Diets Premium
Zaloguj się
Katalog Narzędzi MCP & Endpointów API Platform 5.0
Widgety: Specyfikacja Tabela argumentów Terminal & Odpowiedź Task & Subagent Kafelki narzędzi
Wróć do katalogu narzędzi MCP 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://dietspremium.pl/_mcp/search/food
Mostek CLI (stdio) npx -y dietspremium-mcp
Kontrakt Wejściowy (JSON Schema)

Schemat parametrów wejściowych (inputSchema)

8 Nazwa pola
Nazwa pola Typ JSON Status Opis i przeznaczenie Przykład wartości
query string Wymagany Food item (e.g. "grilled chicken breast", "avocado") —
locale string Opcjonalny Language locale en
proteins_min / proteins_max integer Opcjonalny Protein range in grams 0
kcal_min / kcal_max integer Opcjonalny Calorie range per 100g 0
allergen_exclude string Opcjonalny Comma-separated allergens to exclude —
food_nutrient_include string Opcjonalny Required nutrient (e.g. "iron", "calcium") —
page integer Opcjonalny Page number (10 results per page) 1
ai boolean Opcjonalny AI semantic vector search true

Wywołanie JSON-RPC 2.0 (tools/call)

search_food
terminal — tools/call search_food
JSON-RPC 2.0 REQUEST
npx -y dietspremium-mcp --url https://dietspremium.pl/_mcp 
curl -X POST https://dietspremium.pl/_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
}'

Struktura odpowiedzi narzędzia MCP

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="pl").

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 PL i zwróć ustrukturyzowane dane kliniczne.”

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

Pozostałe narzędzia serwera MCP

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

Udostępnij