Katalog Narzędzi MCP & Endpointów REST API
Native MCP Server for Autonomous AI Agents
Give your AI assistant direct access to 12 clinical search tools and 9 management tools for creating diets, recipes, and workout plans.
https://www.dietspremium.com/_mcp
npx -y dietspremium-mcp
MCP Client Configuration (mcp_config.json)
npx -y dietspremium-mcp
{
"mcpServers": {
"dietspremium": {
"command": "npx",
"args": ["-y", "dietspremium-mcp"],
"env": {
"DIETSPREMIUM_API_KEY": "YOUR_MCP_KEY"
}
}
}
}Connect the MCP Server in 3 Steps
Native support for Claude Desktop, Cursor, Windsurf, Gemini CLI, OpenAI Agents, and LM Studio.
1. Add Entry to mcp_config.json
Use the official npx -y @dietspremium/mcp-server package or the direct /_mcp endpoint URL.
2. Authorize X-API-KEY
Search tools work out of the box; an X-API-KEY unlocks entity creation and editing.
3. Build & Analyze Diets with AI
Your AI agent automatically searches ingredients, computes micronutrients, and saves the complete plan.
| Parametr Środowiska | Wartość / Format | Opis Techniczny |
|---|---|---|
| DIETSPREMIUM_API_KEY | Bearer Token (opcjonalny dla Free Tier) | Klucz autoryzacyjny dla narzędzi management_* oraz wyższych limitów zapytań. |
| command / args | npx -y dietspremium-mcp |
Oficjalny mostek stdio kompatybilny z Node.js 18+ i każdym klientem MCP. |
| Streamable HTTP URL | https://www.dietspremium.com/_mcp |
Bezpośredni punkt końcowy JSON-RPC 2.0 (initialize, tools/list, tools/call). |
Zadania inicjalizacyjne klienta MCP (dietspremium-mcp)
MCP Handshake
Automatyczny przebieg połączenia ze środowiskiem AI
Automatyczny przebieg połączenia ze środowiskiem AI
npx -y dietspremium-mcp
Klient pobiera oficjalną paczkę NPM i zestawia sesję TLS z https://www.dietspremium.com/_mcp.
DIETSPREMIUM_API_KEY=dp_mcp_xxx npx -y dietspremium-mcp
JSON Schema
Agent otrzymuje pełne definicje typów, filtrów makro, jednostek klinicznych oraz walut.
Base64 Key
Narzędzia management_* przyjmują zakodowany klucz "key" zwrócony przez narzędzia search_*.
Semantic & Catalog Search Tools (12 Search Tools)
Read-only tools (/_mcp/search/*) supporting 512d vector queries and clinical filters.
Allergen Risk & Intolerance Registry
Dietary allergens, cross-contamination risks, EU 1169/2011 allergen standards, and ingredient intolerance profiles.
query*
locale
page
max_results
ai
/_mcp/search/allergen
Specyfikacja
Clinical Nutrition Guides & RAG Grounding
Search 6,000+ peer-reviewed nutrition articles, clinical guidelines, and wellness guides for agent grounding and citations.
query*
locale
page
max_results
ai
/_mcp/search/article
Specyfikacja
Dietetic Catering & Clinic Directory
Search 173,000+ health clinics, dietetic catering providers, gyms, and wellness brands with geo-location metadata.
query*
city
locale
page
max_results
/_mcp/search/company
Specyfikacja
Exercise Biomechanics & Calorie Burn
Search 2,000+ workout exercises with targeted anatomical muscle groups, required equipment, and execution guidelines.
query*
locale
page
max_results
ai
/_mcp/search/exercise
Specyfikacja
Nutritional Database & Macro Search
Search 1,900+ verified foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.
query*
locale
proteins_min / proteins_max
kcal_min / kcal_max
allergen_exclude
+3
/_mcp/search/food
Specyfikacja
Pharmacology & Food-Drug Interactions
Database of 53,000+ active substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.
query*
locale
page
max_results
/_mcp/search/medication
Specyfikacja
Culinary Recipes & Macro Balancing
Search 780+ chef-curated recipes with preparation steps, ingredients with gram weights, portion macronutrients, and difficulty levels.
query*
locale
page
max_results
ai
/_mcp/search/recipe
Specyfikacja
Specialists & Certified Dietitians
Search verified clinical dietitians, sports nutritionists, and certified personal trainers for client assignment.
query*
locale
page
max_results
/_mcp/search/user
Specyfikacja
Supplements & Active Dosages
Dietary supplements catalog with active compound dosages, vitamin forms, and safety guidance.
query*
locale
page
max_results
/_mcp/search/supplement
Specyfikacja
Clinical & Lifestyle Diet Templates (158 Types)
Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.
query
diet_template_type
days
avoid_allergens
kcal_min / kcal_max
+4
/_mcp/search/diet
Specyfikacja
Global Food Products & Barcodes (Open Food Facts + USDA)
Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.
query
barcode
brand
locale
currency
+2
/_mcp/search/food-world
Specyfikacja
Clinical Knowledge & Dietetic Grounding
Clinical nutrition guidelines, scientific dietary facts, medical definitions, and evidence-based grounding.
query*
locale
page
max_results
/_mcp/search/knowledge
Specyfikacja
Entity Management & Creation Tools (/_mcp/management/*)
Account, Profile, GeoName Address (Residential, Delivery, Work), Job, Education & S3 Avatar/Cover
Manage your personal profile (first/last name), S3 avatar & background cover images, verified GeoName residential/delivery/work addresses with street mapping, jobs, educations, and personal tags.
/_mcp/management/account
Dokumentacja
Personal & Company Calendar Events Manager
List, create, edit, and delete events in your personal or company calendar with public/private visibility and S3 media attachments.
/_mcp/management/calendar
Dokumentacja
Company, Clinic & Catering Profile Management
Manage owned or assigned companies (CompanyTrainerAssign allow_edit=1): address, Mon-Sun opening hours, website, features, and S3 media.
/_mcp/management/company
Dokumentacja
Patient & Client CRM (List, Add, Edit, Soft-Deactivate)
List your patients, onboard new patients, update patient profiles and clinical notes, or deactivate patient assignments (active = 0).
/_mcp/management/patient
Dokumentacja
Diet Builder (Trainer Mode) & Patient Tracking / Fridge Replacement AI
Dual-mode diet management: Trainer Mode (granted_to=NULL) for full diet/day/meal/recipe/food/supplement/exercise editing, and Patient Mode (granted_to=user) for water/feel/notes logging and AI Fridge Meal Replacement.
/_mcp/management/diet
Dokumentacja
Training Plan Builder (Trainer Mode) & Workout Execution
Create and edit training templates, workout days, exercise sets/reps/tempo/rest, assign plans to patients, or log patient workout notes.
/_mcp/management/training
Dokumentacja
Culinary Recipe Builder & S3 Media Manager
Create and manage culinary recipes, ingredients (RecipeFood), cooking steps (RecipeStep), macros, and S3 media.
/_mcp/management/recipe
Dokumentacja
Food Product & Nutrient Catalog Manager
List, inspect, create, update, and soft-deactivate food products (Food) with nutrients, measure units, allergens, blood types, and S3 media.
/_mcp/management/food
Dokumentacja
Dietary Supplement Catalog Manager
List, inspect, create, update, and soft-deactivate dietary supplements with active nutrient dosages and S3 media.
/_mcp/management/supplement
Dokumentacja
Medication & Drug-Food Interaction Manager
List, inspect, create, update, and soft-deactivate medications with ATC codes, contraindications, and S3 media.
/_mcp/management/medication
Dokumentacja
Exercise & Biomechanics Catalog Manager
List, inspect, create, update, and soft-deactivate physical exercises with METs, instructions, and S3 media.
/_mcp/management/exercise
Dokumentacja
Exercise Bundle & Circuit Manager
Create, update, and soft-deactivate exercise bundles/circuits and manage assigned exercises within bundles.
/_mcp/management/exercise-bundle
Dokumentacja
Food Allergen Catalog Manager
List, inspect, create, update, and soft-deactivate food allergens with SEO metadata and S3 media.
/_mcp/management/allergen
Dokumentacja
Zestawienie Tabelaryczne Narzędzi Wyszukiwania MCP
tools/call| Narzędzie MCP | Zasób | Endpoint HTTP |
|---|---|---|
| search_allergen | Allergen Risk & Intolerance Registry | /_mcp/search/allergen |
| search_article | Clinical Nutrition Guides & RAG Grounding | /_mcp/search/article |
| search_company | Dietetic Catering & Clinic Directory | /_mcp/search/company |
| search_exercise | Exercise Biomechanics & Calorie Burn | /_mcp/search/exercise |
| search_food | Nutritional Database & Macro Search | /_mcp/search/food |
| search_medication | Pharmacology & Food-Drug Interactions | /_mcp/search/medication |
| search_recipe | Culinary Recipes & Macro Balancing | /_mcp/search/recipe |
| search_user | Specialists & Certified Dietitians | /_mcp/search/user |
| search_supplement | Supplements & Active Dosages | /_mcp/search/supplement |
| search_diet | Clinical & Lifestyle Diet Templates (158 Types) | /_mcp/search/diet |
| search_food_world | Global Food Products & Barcodes (Open Food Facts + USDA) | /_mcp/search/food-world |
| search_knowledge | Clinical Knowledge & Dietetic Grounding | /_mcp/search/knowledge |
curl -X POST https://www.dietspremium.com/_mcp -H "Content-Type: application/json"
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [
{
"type": "text",
"text": "Found 1 matching recipe: Wysokobiałkowy omlet ze szpinakiem (key: OTI=, 380 kcal, P: 32.0g, F: 18.0g, C: 6.0g)"
}
]
}
}MCP v2 Protocol Architecture
Unified JSON-RPC 2.0 transport over Streamable HTTP and the dietspremium-mcp NPM stdio bridge.
Compliant with the latest Model Context Protocol specification (tools/list, tools/call).
Deterministic entity identifiers enabling seamless references between search and management tools.
Semantic matching across foods, recipes, and diets powered by the google/embeddinggemma-2 cluster.
Subagent MCP z obsługą kluczy Base64 (McpKeyCodec)
“Wyszukaj produkty bogate w magnez bez glutenu i zapisz nowy szablon posiłku w koncie pacjenta.”
1. tools/call search_food({query: "pestki dyni", allergen_exclude: "gluten"}) → key: "NDg="
2. tools/call management_diet({action: "create", food_keys: ["NDg="]}) → 200 OKPakiety Tokenów AI, MCP & API (Doładowanie Bezterminowe)
Kup pakiet tokenów bez subskrypcji (także bez konta — podaj e-mail w koszyku, a automatycznie utworzymy Twoje konto oraz klucz MCP) lub doładuj obecne konto. Pakiety nigdy nie wygasają.