Katalog Narzędzi MCP & Endpointów API Platform 5.0
Infrastruktura Danych Żywieniowych dla Agentów AI oraz Aplikacji Medycznych
Połącz modele językowe (Claude, ChatGPT, Gemini, Cursor) przez natywny protokół MCP lub zbuduj własną aplikację w oparciu o szybkie REST API.
/_mcp
Serwer MCP dla Agentów AI i LLM
21 natywnych narzędzi wyszukiwania wektorowego 512d oraz zarządzania dietami, przepisami i treningami.
/api/v1/*
Klasyczne REST API (OpenAPI 3.1)
Niskie opóźnienia, deterministyczne odpowiedzi JSON i filtrowanie w 9 językach dla aplikacji webowych i mobilnych.
Porównanie Architektury MCP v2.0 oraz REST API v1
| Warstwa | MCP v2.0 | REST API v1 |
|---|---|---|
| Transport | https://dietspremium.pl/_mcp | https://dietspremium.pl/api/v1 |
| Pakiet CLI / SDK | npx -y dietspremium-mcp |
fetch, axios, cURL |
| Autoryzacja | DIETSPREMIUM_API_KEY |
Authorization: Bearer |
| Identyfikatory | Base64 key (McpKeyCodec) |
id / slug / key |
| Silnik AI | OpenSearch 512d k-NN + BM25 | Parametr ai=true |
Konfiguracja Klienta AI & REST cURL
npx -y dietspremium-mcp --url https://dietspremium.pl/_mcp
{
"mcpServers": {
"dietspremium": {
"command": "npx",
"args": ["-y", "dietspremium-mcp"],
"env": {
"DIETSPREMIUM_API_KEY": "YOUR_MCP_KEY"
}
}
}
}
Kafelki Domenowe — Narzędzia MCP (/_mcp/*) i Endpointy REST API (/api/v1/*)
Dietary allergens, cross-contamination risks, EU 1169/2011 allergen standards, and ingredient intolerance profiles.
Search 6,000+ peer-reviewed nutrition articles, clinical guidelines, and wellness guides for agent grounding and citations.
Search 173,000+ health clinics, dietetic catering providers, gyms, and wellness brands with geo-location metadata.
Search 2,000+ workout exercises with targeted anatomical muscle groups, required equipment, and execution guidelines.
Search 1,900+ verified foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.
Database of 53,000+ active substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.
Search 780+ chef-curated recipes with preparation steps, ingredients with gram weights, portion macronutrients, and difficulty levels.
Search verified clinical dietitians, sports nutritionists, and certified personal trainers for client assignment.
Dietary supplements catalog with active compound dosages, vitamin forms, and safety guidance.
Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.
Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.
Clinical nutrition guidelines, scientific dietary facts, medical definitions, and evidence-based grounding.
Tabela Zbiorcza Narzędzi MCP i Endpointów REST API
| Domena | Narzędzie MCP | Endpoint REST API |
|---|---|---|
| Allergen Risk & Intolerance Registry | search_allergen | POST /api/v1/allergen |
| Clinical Nutrition Guides & RAG Grounding | search_article | POST /api/v1/article |
| Dietetic Catering & Clinic Directory | search_company | POST /api/v1/company |
| Exercise Biomechanics & Calorie Burn | search_exercise | POST /api/v1/exercise |
| Nutritional Database & Macro Search | search_food | POST /api/v1/food |
| Pharmacology & Food-Drug Interactions | search_medication | POST /api/v1/medication |
| Culinary Recipes & Macro Balancing | search_recipe | POST /api/v1/recipe |
| Specialists & Certified Dietitians | search_user | POST /api/v1/specialist |
| Supplements & Active Dosages | search_supplement | POST /api/v1/supplement |
| Clinical & Lifestyle Diet Templates (158 Types) | search_diet | POST /api/v1/diet |
| Global Food Products & Barcodes (Open Food Facts + USDA) | search_food_world | /_mcp/search/food-world
|
| Clinical Knowledge & Dietetic Grounding | search_knowledge | POST /api/v1/knowledge |
curl -s -X POST https://dietspremium.pl/_mcp -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_MCP_KEY"
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Found 1 matching food: Łosoś atlantycki świeży (key: MTQ=, 208 kcal, P: 20.4g, F: 13.4g, C: 0.0g)"
}
]
}
}
Przepływ pracy Agenta AI (MCP + REST API)
4 Kroki
Standardowy protokół komunikacji z bazą DietsPremium
Standardowy protokół komunikacji z bazą DietsPremium
POST /_mcp
Klient AI (Claude, Cursor, Antigravity) pobiera listę 12 narzędzi wyszukiwania oraz 9 narzędzi zarządzania wraz ze schematami JSON Schema.
{"method": "tools/list", "params": {}}
OpenSearch 512d
Zapytanie trafia do klastra wektorowego i zwraca encje wraz z zakodowanym kluczem Base64 (pole "key").
{"name": "search_food", "arguments": {"query": "pierś z indyka", "locale": "pl"}}
McpKeyCodec
Narzędzia zarządzania przyjmują wyłącznie bezpieczny klucz Base64 "key" zwrócony przez wyszukiwarkę (nigdy surowy integer ID).
{"name": "management_diet", "arguments": {"action": "get", "key": "MTA4"}}
S3 + Doctrine
Przepisy, produkty i szablony diet automatycznie przeliczają makroskładniki, alergeny oraz miniatury WebP/AVIF.
Autonomiczny Asystent Dietetyki Klinicznej i Treningu
“Stwórz 7-dniowy jadłospis DASH 2000 kcal bez laktozy, sprawdź interakcje z lekiem Euthyrox i wygeneruj listę zakupów z cenami w PLN.”
→ call search_medication({query: "Lewotyroksyna", locale: "pl"})
← 200 OK: Zachowaj 4h odstępu od suplementów wapnia i żelaza
→ call search_diet({diet_template_type: "dash", kcal_min: 1950, kcal_max: 2050, avoid_allergens: ["milk"]})
← 200 OK: Znaleziono szablon key="MTA4" (2010 kcal, sód < 1500mg)Najczęstsze pytania o integrację API i MCP
Protokół MCP v2.0 (Model Context Protocol) pozwala agentom AI (Claude Desktop, Cursor, ChatGPT, Gemini) bezpośrednio wyszukiwać produkty, przepisy, leki oraz generować diety i plany treningowe w czasie rzeczywistym, natomiast REST API v1 służy do integracji backendowych i mobilnych (JSON/OpenAPI 3.1).
Pakiet B2C Personal PRO zawiera 5 000 000 tokenów MCP oraz 500 zapytań REST API miesięcznie. Pakiet B2B Trener PRO zapewnia 50 000 000 tokenów MCP i 1 000 zapytań API/mies., a Studio PRO aż 250 000 000 tokenów MCP i 10 000 zapytań API miesięcznie.
W każdej chwili możesz dokupić przedpłacone pakiety tokenów Overhead (Prepaid Token Packs: 5M, 50M lub 250M tokenów), które nie wygasają z końcem miesiąca i są automatycznie uruchamiane po wyczerpaniu puli abonamentowej.
W panelu konta wygenerujesz klucz Bearer API (dp_live_...) oraz skonfigurujesz OAuth 2.1 + PKCE lub SAML 2.0 SSO dla zespołów klinicznych i studiów treningowych.
Tak — oprócz 12 narzędzi wyszukiwania wektorowego 512d otrzymujesz 15 narzędzi zarządzania (/_mcp/management/*) do tworzenia i edycji diet, planów treningowych, przepisów, pacjentów oraz kalendarza.