Diets Premium Diets Premium
Sign in
MCP Tools & API Platform 5.0 Endpoints
Sections: Specyfikacja Tabela argumentów Terminal & Odpowiedź Task & Subagent Kafelki narzędzi
Back to MCP Tools Catalog search_food_world JSON-RPC 2.0 • tools/call
POST /api/v1/food-world

Global Food Products & Barcodes (Open Food Facts + USDA)

Comprehensive global food catalog integrating Open Food Facts and USDA FoodData Central. Query products by commercial barcode (EAN-13, UPC), manufacturer brand, localized product title, categories, and country of origin with multi-currency pricing.

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

Input Parameters Schema (inputSchema)

7 Field name
Field name JSON Type Status Description Example value
query string Optional Product name or keywords (e.g. "Coca-Cola Zero", "Nutella") —
barcode string Optional EAN-13 or UPC barcode string (e.g. "5449000000996") —
brand string Optional Manufacturer / brand name (e.g. "Barilla", "Nestle") —
locale string Optional Target language locale en
currency string Optional Currency for pricing (EUR, PLN, USD, ALL) locale default
page integer Optional Page number (10 results per page) 1
max_results integer Optional Maximum results (max 10) 10

JSON-RPC 2.0 Request (tools/call)

search_food_world
terminal — tools/call search_food_world
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-world \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_MCP_KEY" \
  -d '{
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL",
  "page": 1
}'

MCP Tool Response Structure

application/json • UTF-8
response — search_food_world (JSON-RPC 2.0)
MCP Response 200 OK 
{
  "content": [
    {
      "type": "text",
      "text": "Product: Barilla Spaghetti n.5 (EAN: 8076809513753) - Nutri-Score: A, Eco-Score: B. Calories: 359 kcal, Protein: 12.5g, Carbs: 70.9g. Price: 1.49 EUR (6.49 PLN)."
    }
  ]
}
Kroki wykonania dla search_food_world MCP Flow

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

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_world Ready

Specjalizowany Agent dla narzędzia search_food_world

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

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

Wykorzystywane Narzędzia MCP / Endpointy
search_food_world
Ślad Wywołania (Execution Trace) 
→ POST https://www.dietspremium.com/_mcp/search/food-world (tool: "search_food_world")
← 200 OK (7 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_food Nutritional Database & Macro Search
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_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