Diets Premium
Model Context Protocol 2024.11 • Silnik Semantyczny JSON-RPC 2.0 npm: dietspremium-mcp

Integracja Model Context Protocol (MCP)

Połącz Claude Desktop, Cursor IDE, LM Studio lub własne aplikacje z bazą wiedzy żywieniowej i silnikiem semantycznym Diets Premium przez protokół MCP.

MCP Tools
12 Tools
Semantic Search
Semantic Search
Supported Clients
Claude / Cursor
Standard
MCP 2024.11
1

Krok 1: Wdrożenie i Zasada Działania MCP

Model Context Protocol pozwala modelom LLM bezpiecznie wywoływać narzędzia katalogowe Diets Premium z automatycznym dopasowywaniem parametrów.

Pakiet Darmowy MCP

Darmowy pakiet 10 000 tokenów/dzień na testowanie z zewnętrznymi integracjami. Zalogowane konta otrzymują bonus +10 000 tokenów/dzień.

Uwierzytelnianie MCP Secret

W panelu konta wygenerujesz unikalny MCP Secret do konfiguracji w plikach konfiguracyjnych Twojego klienta MCP.

Połączenie Bezpośrednie i Szybkość

Serwer MCP przetwarza zapytania JSON-RPC 2.0 bezpośrednio przez silnik semantyczny Diets Premium z minimalnym opóźnieniem.

2

Krok 2: Konfiguracja Klientów MCP (Claude, Cursor, LM Studio, Python)

Skonfiguruj połączenie z serwerem MCP Diets Premium w Twoim środowisku programistycznym lub zewnętrznym asystencie.

npm
dietspremium-mcp
Official npm package: npm i dietspremium-mcp or npx -y dietspremium-mcp
View on npmjs.com
MCP Protocol Endpoint
https://www.dietspremium.com/_mcp
Authentication Format
Authorization: Bearer YOUR_MCP_SECRET
Content-Type: application/json
Protocol: JSON-RPC 2.0
MCP Client Configuration Files
Claude Desktop Config (claude_desktop_config.json) macOS / Windows / Linux 
{
  "mcpServers": {
    "dietspremium": {
      "command": "npx",
      "args": [
        "-y",
        "dietspremium-mcp",
        "--auth",
        "Bearer YOUR_MCP_SECRET"
      ]
    }
  }
}
Cursor IDE (.cursor/mcp.json) Cursor Settings → Features → MCP 
{
  "mcpServers": {
    "dietspremium": {
      "command": "npx",
      "args": [
        "-y",
        "dietspremium-mcp",
        "--auth",
        "Bearer YOUR_MCP_SECRET"
      ]
    }
  }
}
Raw JSON-RPC 2.0 HTTP POST Call Terminal / curl 
curl -X POST "https://www.dietspremium.com/_mcp" \
  -H "Authorization: Bearer YOUR_MCP_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "food",
      "arguments": {
        "query": "grilled chicken breast",
        "locale": "en",
        "proteins_min": 25,
        "ai": true
      }
    }
  }'
3

Krok 3: Katalog Narzędzi MCP (Alfabetycznie)

Przegląd wszystkich 9 narzędzi MCP dostępnych dla zewnętrznych asystentów wraz ze schematami argumentów i przykładowymi wywołaniami JSON-RPC 2.0.

SEARCH TOOL allergen POST /_mcp/search/allergen

Allergen Risk & Intolerance Registry

Allergology & Safety Protocol
Safety Protocol Documentation & Live Examples

Dietary allergens, cross-contamination risks, EU 1169/2011 allergen standards, and ingredient intolerance profiles.

Tool Argument Schema
Argument Type Status Default Description
query string required — Allergen name or food derivative (e.g. "casein", "peanut", "gluten")
locale string optional en Language locale (en, pl, de, fr, nl, cz, at, ch, lu)
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Maximum results per page (max 10)
ai boolean optional true Semantic AI query matching
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "allergen",
    "arguments": {
  "query": "lactose dairy whey",
  "locale": "en",
  "page": 1,
  "max_results": 5
}
  }
}
SEARCH TOOL article POST /_mcp/search/article

Clinical Nutrition Guides & RAG Grounding

Publications & Knowledge Base
Semantic AI RAG Documentation & Live Examples

Search 6,000+ peer-reviewed nutrition articles, clinical guidelines, and wellness guides for agent grounding and citations.

Tool Argument Schema
Argument Type Status Default Description
query string required — Clinical inquiry or dietetics topic (e.g. "intermittent fasting autophagy")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Max results to return (max 10)
ai boolean optional true Semantic AI vector search
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "article",
    "arguments": {
  "query": "ketogenic diet epilepsy neuroprotection",
  "locale": "en",
  "page": 1,
  "max_results": 3,
  "ai": true
}
  }
}
SEARCH TOOL company POST /_mcp/search/company

Dietetic Catering & Clinic Directory

B2B & Directory
Directory & Geo Documentation & Live Examples

Search 173,000+ health clinics, dietetic catering providers, gyms, and wellness brands with geo-location metadata.

Tool Argument Schema
Argument Type Status Default Description
query string required — Company name, specialty, or city (e.g. "low FODMAP catering Berlin")
city string optional — Optional city name filter (e.g. "Warszawa", "Berlin")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "company",
    "arguments": {
  "query": "catering dietetyczny bezglutenowy Warszawa",
  "locale": "pl",
  "page": 1,
  "max_results": 5
}
  }
}
SEARCH TOOL exercise POST /_mcp/search/exercise

Exercise Biomechanics & Calorie Burn

Fitness & Biomechanics
Biomechanics Documentation & Live Examples

Search 2,000+ workout exercises with targeted anatomical muscle groups, required equipment, and execution guidelines.

Tool Argument Schema
Argument Type Status Default Description
query string required — Exercise name, equipment, or muscle group (e.g. "incline dumbbell press")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
ai boolean optional true AI semantic search
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exercise",
    "arguments": {
  "query": "dumbbell Romanian deadlift hamstrings",
  "locale": "en",
  "page": 1,
  "max_results": 5,
  "ai": true
}
  }
}
SEARCH TOOL food POST /_mcp/search/food

Nutritional Database & Macro Search

Nutrition & Macros
Advanced Filters Documentation & Live Examples

Search 1,900+ verified foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.

Tool Argument Schema
Argument Type Status Default Description
query string required — Food item (e.g. "grilled chicken breast", "avocado")
locale string optional en Language locale
proteins_min / proteins_max integer optional 0 Protein range in grams
kcal_min / kcal_max integer optional 0 Calorie range per 100g
allergen_exclude string optional — Comma-separated allergens to exclude
food_nutrient_include string optional — Required nutrient (e.g. "iron", "calcium")
page integer optional 1 Page number (10 results per page)
ai boolean optional true AI semantic vector search
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "food",
    "arguments": {
  "query": "chicken breast",
  "locale": "en",
  "proteins_min": 25,
  "kcal_max": 250,
  "allergen_exclude": "gluten,lactose",
  "page": 1,
  "max_results": 5,
  "ai": true
}
  }
}
SEARCH TOOL medication POST /_mcp/search/medication

Pharmacology & Food-Drug Interactions

Pharmacology & Safety
Safety Protocol Documentation & Live Examples

Database of 53,000+ active substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.

Tool Argument Schema
Argument Type Status Default Description
query string required — Pharmaceutical compound or trade name (e.g. "Levothyroxine", "Metformin")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "medication",
    "arguments": {
  "query": "Levothyroxine calcium coffee interaction",
  "locale": "en",
  "page": 1,
  "max_results": 5
}
  }
}
SEARCH TOOL recipe POST /_mcp/search/recipe

Culinary Recipes & Macro Balancing

Culinary & Meal Prep
Culinary Database Documentation & Live Examples

Search 780+ chef-curated recipes with preparation steps, ingredients with gram weights, portion macronutrients, and difficulty levels.

Tool Argument Schema
Argument Type Status Default Description
query string required — Search phrase (e.g. "quick keto salmon salad", "vegan high-protein pasta")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
ai boolean optional true Semantic AI search
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "recipe",
    "arguments": {
  "query": "quick keto Mediterranean avocado salmon salad",
  "locale": "en",
  "page": 1,
  "max_results": 5,
  "ai": true
}
  }
}
SEARCH TOOL user POST /_mcp/search/user

Specialists & Certified Dietitians

Specialists & Trainers
Directory Documentation & Live Examples

Search verified clinical dietitians, sports nutritionists, and certified personal trainers for client assignment.

Tool Argument Schema
Argument Type Status Default Description
query string required — Specialist specialty, qualification, or city (e.g. "clinical dietitian diabetes")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "user",
    "arguments": {
  "query": "clinical sports dietitian keto specialist",
  "locale": "en",
  "page": 1,
  "max_results": 5
}
  }
}
SEARCH TOOL supplement POST /_mcp/search/supplement

Supplements & Active Dosages

Nutrition & Supplements
Dosage Safety Documentation & Live Examples

Dietary supplements catalog with active compound dosages, vitamin forms, and safety guidance.

Tool Argument Schema
Argument Type Status Default Description
query string required — Supplement or vitamin name (e.g. "Vitamin D3 K2 MK7", "Creatine Monohydrate")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "supplement",
    "arguments": {
  "query": "Vitamin D3 K2 MK7 high absorption",
  "locale": "en",
  "page": 1,
  "max_results": 5
}
  }
}
SEARCH TOOL diet POST /_mcp/search/diet

Clinical & Lifestyle Diet Templates (158 Types)

Odżywianie & Diety
158 Clinical Types Documentation & Live Examples

Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.

Tool Argument Schema
Argument Type Status Default Description
query string optional — Search keyword or medical condition (e.g. "keto", "cukrzyca")
diet_template_type string|int optional — Diet template type ID, find code, or localized name (e.g. "keto", "hashimoto", 4)
days integer optional — Duration in days (e.g. 7, 14, 21, 28)
avoid_allergens array optional [] Allergen find codes to strictly exclude (e.g. ["milk", "nuts"])
kcal_min / kcal_max integer optional 0 Daily calorie bounds
currency string optional locale default Currency for pricing (PLN, EUR, USD, ALL)
locale string optional en Language locale (en, pl, de, etc.)
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Max items to return (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "diet",
    "arguments": {
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl",
  "page": 1
}
  }
}
SEARCH TOOL food-world POST /_mcp/search/food-world

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

Global Products & Barcodes
Global Barcode DB Documentation & Live Examples

Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.

Tool Argument Schema
Argument Type Status Default Description
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 en Target language locale
currency string optional locale default Currency for pricing (EUR, PLN, USD, ALL)
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Maximum results (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "food-world",
    "arguments": {
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL",
  "page": 1
}
  }
}
SEARCH TOOL knowledge POST /_mcp/search/knowledge

Clinical Knowledge & Dietetic Grounding

Publications & Knowledge Base
Medical Grounding Documentation & Live Examples

Clinical nutrition guidelines, scientific dietary facts, medical definitions, and evidence-based grounding.

Tool Argument Schema
Argument Type Status Default Description
query string required — Scientific inquiry or term (e.g. "insulin resistance", "glycemic index")
locale string optional en Language locale
page integer optional 1 Page number (10 results per page)
max_results integer optional 10 Number of results (max 10)
JSON-RPC 2.0 tools/call Payload 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge",
    "arguments": {
  "query": "insulinooporność mechanizm",
  "locale": "pl",
  "page": 1,
  "max_results": 3
}
  }
}
4

MCP Management Endpoints (/_mcp/management/<entity>)

Authenticated account, calendar, company, patient, diet (Trainer Mode vs Patient granted_to + Fridge Replacement AI), and training management via MCP Token. All entities use Base64 key identifiers (never raw database IDs) with S3 media support (GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA).

MANAGEMENT management_account POST /_mcp/management/account

Account, Profile, GeoName Address (Residential, Delivery, Work), Job, Education & S3 Avatar/Cover

Account & Profile Management
Personal Account Documentation & Live Examples

Full authenticated management of the user account via MCP Token. Supports updating first/last name, uploading/replacing/deleting avatar and background cover photos on S3 (dietpremium-media), interactive GeoName address & street lookup (SEARCH_COUNTRY, SEARCH_CITY, SEARCH_ZIP, SEARCH_STREET, UPDATE_ADDRESS), delivery addresses (LIST_DELIVERY_ADDRESSES, ADD_DELIVERY_ADDRESS, UPDATE_DELIVERY_ADDRESS, DELETE_DELIVERY_ADDRESS), work/practice addresses (LIST_WORK_ADDRESSES, ADD_WORK_ADDRESS, UPDATE_WORK_ADDRESS, DELETE_WORK_ADDRESS), job history (LIST_JOBS, SEARCH_AVAILABLE_JOBS, ADD_JOB, UPDATE_JOB, DELETE_JOB), education history, and personal tags. Email and phone number modifications are strictly blocked for security (require 2FA code on web).

Tool Argument Schema
Argument Type Status Default Description
action string required GET_PROFILE Action: GET_PROFILE, UPDATE_PERSONAL_DATA, UPDATE_PROFILE, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA, GET_ADDRESS, SUGGEST_ADDRESS, RESOLVE_ADDRESS, SEARCH_COUNTRY, LIST_ACTIVE_COUNTRIES, SEARCH_CITY, SEARCH_ZIP, SEARCH_STREET, LIST_STREETS, UPDATE_ADDRESS, LIST_DELIVERY_ADDRESSES, ADD_DELIVERY_ADDRESS, UPDATE_DELIVERY_ADDRESS, DELETE_DELIVERY_ADDRESS, LIST_WORK_ADDRESSES, ADD_WORK_ADDRESS, UPDATE_WORK_ADDRESS, DELETE_WORK_ADDRESS, LIST_JOBS, SEARCH_AVAILABLE_JOBS, UPDATE_PROFESSIONS, LIST_EDUCATIONS, UPDATE_EDUCATION, LIST_TAGS, SEARCH_AVAILABLE_TAGS, UPDATE_TAGS
payload object optional {} Action parameters (e.g. firstname, lastname, street, street_key, house_number/building_number, flat_number, country_key/country_iso, city_key/city, zip_key/zip, delivery_address_key, work_address_key, company_name, nip, image_base64, filename, target)
locale string optional pl Language locale (pl, en, de, fr, nl, cz, at, ch, lu)
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/account) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_account",
    "arguments": {
  "action": "UPDATE_PROFILE",
  "payload": {
    "firstname": "Anna",
    "lastname": "Kowalska"
  },
  "locale": "pl"
}
  }
}
MANAGEMENT management_calendar POST /_mcp/management/calendar

Personal & Company Calendar Events Manager

Calendar & Scheduling
Events & Media Documentation & Live Examples

Manage personal and company calendar events via MCP. Supports date-range filtering, public/private visibility toggles, linking events to a managed Company (via company_key), and attaching S3 images or videos.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_EVENTS Action: LIST_EVENTS, GET_EVENT, ADD_EVENT, UPDATE_EVENT, DELETE_EVENT, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Event payload (key, title, description, event_date, start_time, end_time, company_key, is_public, image_base64, filename)
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/calendar) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_calendar",
    "arguments": {
  "action": "ADD_EVENT",
  "payload": {
    "title": "Konsultacja kontrolna - Analiza składu ciała",
    "event_date": "2026-11-05",
    "start_time": "10:00",
    "end_time": "11:00",
    "is_public": true
  },
  "locale": "pl"
}
  }
}
MANAGEMENT management_company POST /_mcp/management/company

Company, Clinic & Catering Profile Management

B2B & Clinic Management
Trainer & Company Documentation & Live Examples

Dedicated B2B management tool for Trainer and Company accounts. Allows listing and updating companies created by the user or assigned via CompanyTrainerAssign with edit permissions. Supports GeoName address verification, Monday-Sunday opening hours, company features, and S3 gallery images/videos.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_COMPANIES Action: LIST_COMPANIES, GET_COMPANY, CREATE_COMPANY, UPDATE_COMPANY, UPDATE_ADDRESS, UPDATE_OPEN_HOURS, DELETE_COMPANY, DEACTIVATE_COMPANY, LIST_TRAINERS, ASSIGN_TRAINER, UPDATE_TRAINER_ASSIGNMENT, UNASSIGN_TRAINER, LIST_AVAILABLE_FEATURES, SUGGEST_ADDRESS, RESOLVE_ADDRESS, SEARCH_COUNTRY, LIST_ACTIVE_COUNTRIES, SEARCH_CITY, SEARCH_ZIP, SEARCH_STREET, LIST_STREETS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Company key, name, www, address fields (street, street_key, house_number/building_number, flat_number, country_key/country_iso, city_key/city, zip_key/zip), opening hours, trainer_key, show_on_frontend, allow_edit, feature_keys, or S3 media
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/company) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_company",
    "arguments": {
  "action": "LIST_COMPANIES",
  "page": 1,
  "max_results": 10,
  "locale": "pl"
}
  }
}
MANAGEMENT management_patient POST /_mcp/management/patient

Patient & Client CRM (List, Add, Edit, Soft-Deactivate)

Specialist & Patient CRM
Trainer CRM Documentation & Live Examples

Specialist CRM tool for trainers and clinical dietitians. Manage your patient roster with paginated listings (max 10 per page), inspect assigned diets and training plans, onboard new patients, update clinical notes, and safely deactivate patients via soft-delete (active = 0).

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_PATIENTS Action: LIST_PATIENTS, LIST_TRAINERS, GET_PATIENT, ADD_PATIENT, UPDATE_PATIENT, UPDATE_PATIENT_ADDRESS, DELETE_PATIENT, DEACTIVATE_PATIENT, ASSIGN_PATIENT_TO_TRAINER, LIST_PATIENT_DELIVERY_ADDRESSES, ADD_PATIENT_DELIVERY_ADDRESS, UPDATE_PATIENT_DELIVERY_ADDRESS, DELETE_PATIENT_DELIVERY_ADDRESS, LIST_PATIENT_WORK_ADDRESSES, ADD_PATIENT_WORK_ADDRESS, UPDATE_PATIENT_WORK_ADDRESS, DELETE_PATIENT_WORK_ADDRESS, SUGGEST_ADDRESS, RESOLVE_ADDRESS, SEARCH_COUNTRY, SEARCH_CITY, SEARCH_ZIP, SEARCH_STREET, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Patient key (patient_key), trainer_key, firstname, lastname, gender, age, address, delivery_address, work_address, street_key, house_number/building_number, body_measure, tags, health_ids, notes
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/patient) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_patient",
    "arguments": {
  "action": "LIST_PATIENTS",
  "page": 1,
  "max_results": 10,
  "locale": "pl"
}
  }
}
MANAGEMENT management_diet POST /_mcp/management/diet

Diet Builder (Trainer Mode) & Patient Tracking / Fridge Replacement AI

Odżywianie & Diety (Management)
Trainer & Patient AI Documentation & Live Examples

Intelligent dual-mode diet engine:\n1) Trainer Mode (granted_to IS NULL & created_by == user): Create and edit diets, add/remove days, meal schemas, recipes, foods, supplements, exercises, upload S3 media, and assign diet copies to patients (ASSIGN_TO_PATIENT). Trainers cannot edit personal patient logs (water, feel, notice, smoke).\n2) Recipient/Patient Mode (granted_to == user): View assigned diet, log daily water intake (LOG_WATER), mood/wellbeing (LOG_FEEL), personal notes (LOG_NOTICE), biohacking/smoke (LOG_BIOHACKING), and evaluate fridge ingredients against scheduled meals (EVALUATE_FRIDGE_REPLACEMENT). Physical meal swaps (REPLACE_MEAL) are permitted when allowEditMeals=1.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_DIETS Trainer/Admin: GET_CREATION_GUIDE, LIST_DIETS, GET_DIET, GET_DAY, CREATE_DIET, UPDATE_DIET, DELETE_DIET, DEACTIVATE_DIET, ADD_DAY, UPDATE_DAY, DELETE_DAY, ADD_SCHEMA, UPDATE_SCHEMA, DELETE_SCHEMA, ADD_ITEM, UPDATE_ITEM, REMOVE_ITEM, ASSIGN_TO_PATIENT, LIST_DIET_TYPES, LIST_DIET_GOALS, LIST_SCHEMA_TYPES, LIST_CATEGORIES, LIST_TAGS, LIST_CONNECTS, CREATE_CONNECT, UPDATE_CONNECT, ASSIGN_CONNECT, UNASSIGN_CONNECT, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA. Patient: EVALUATE_FRIDGE_REPLACEMENT, REPLACE_MEAL, LOG_WATER, LOG_FEEL, LOG_NOTICE, LOG_SMOKE, LOG_BIOHACKING, GET_TRACKING_LOGS
payload object optional {} Diet key (diet_key), scope (templates|assigned|store|all), patient_key, day_key, schema_key, item_type (recipe|food|supplement|exercise|exercise_bundle), fridge_ingredients, water_ml, feel_score, notice
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/diet) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_diet",
    "arguments": {
  "action": "EVALUATE_FRIDGE_REPLACEMENT",
  "payload": {
    "diet_key": "MTA4",
    "day_key": "NTIw",
    "schema_key": "MjEwNA==",
    "fridge_ingredients": [
      {"name": "jajka", "grams": 180},
      {"name": "awokado", "grams": 70},
      {"name": "szpinak", "grams": 100}
    ]
  },
  "locale": "pl"
}
  }
}
MANAGEMENT management_training POST /_mcp/management/training

Training Plan Builder (Trainer Mode) & Workout Execution

Fitness & Biomechanics (Management)
Workout Builder Documentation & Live Examples

Dual-mode training plan management:\n1) Trainer Mode (granted_to IS NULL & created_by == user): Full CRUD on training templates, workout days, exercise assignments (sets, reps, weight, rest, tempo), S3 media, and ASSIGN_TO_PATIENT.\n2) Recipient/Patient Mode (granted_to == user): Read assigned workout plan, log workout feedback (LOG_WORKOUT_NOTE), and swap exercises when trainer enabled editing.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_TRAININGS Action: GET_CREATION_GUIDE, LIST_TRAININGS, GET_TRAINING, GET_DAY, CREATE_TRAINING, UPDATE_TRAINING, DELETE_TRAINING, DEACTIVATE_TRAINING, ADD_DAY, UPDATE_DAY, DELETE_DAY, ADD_SCHEMA, UPDATE_SCHEMA, DELETE_SCHEMA, ADD_EXERCISE, UPDATE_EXERCISE, REMOVE_EXERCISE, ASSIGN_TO_PATIENT, LIST_TRAINING_TYPES, LIST_TRAINING_GOALS, LIST_SCHEMA_TYPES, LIST_CATEGORIES, LIST_TAGS, LOG_WORKOUT_NOTE, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Training key (training_key), scope (templates|assigned|store|all), patient_key, day_key, schema_key, exercise_key, sets, reps, rest_seconds, note
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/training) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_training",
    "arguments": {
  "action": "LIST_TRAININGS",
  "payload": {
    "mode": "trainer"
  },
  "page": 1,
  "locale": "pl"
}
  }
}
MANAGEMENT management_recipe POST /_mcp/management/recipe

Culinary Recipe Builder & S3 Media Manager

Culinary & Meal Prep (Management)
Recipe Builder AI Documentation & Live Examples

Dedicated MCP endpoint for AI-assisted creation and editing of culinary recipes. Supports GET_CREATION_GUIDE, paginated listing, full recipe inspection, creating recipes with ingredients and step-by-step instructions, updating/removing ingredients, and managing S3 images/videos.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_RECIPES Action: GET_CREATION_GUIDE, LIST_RECIPES, GET_RECIPE, CREATE_RECIPE, UPDATE_RECIPE, DELETE_RECIPE, DEACTIVATE_RECIPE, ADD_INGREDIENT, UPDATE_INGREDIENT, REMOVE_INGREDIENT, ADD_STEP, UPDATE_STEP, DELETE_STEP, LIST_MEASURE_UNITS, LIST_DIET_TYPES, LIST_CATEGORIES, LIST_TAGS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Recipe key (recipe_key), name_pl, time, hard, portions, kcal_total, ingredients, steps, image_base64, filename
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/recipe) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_recipe",
    "arguments": {
  "action": "GET_CREATION_GUIDE",
  "locale": "pl"
}
  }
}
MANAGEMENT management_food POST /_mcp/management/food

Food Product & Nutrient Catalog Manager

Odżywianie & Diety (Management)
Food Catalog AI Documentation & Live Examples

Full CRUD management for Food products (`/_mcp/management/food`). Supports GET_CREATION_GUIDE, macro/micronutrient assignment (`FoodNutrientAssign`), measure units (`LIST_MEASURE_UNITS`), allergens, categories, tags, and S3 media.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_FOODS Action: GET_CREATION_GUIDE, LIST_FOODS, GET_FOOD, CREATE_FOOD, UPDATE_FOOD, DELETE_FOOD, DEACTIVATE_FOOD, LIST_NUTRIENTS, LIST_MEASURE_UNITS, LIST_CATEGORIES, LIST_TAGS, LIST_ALLERGENS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Food key (food_key), name_pl/de/en, kcal, protein, fat, carbohydrate, fiber, gi, nutrients, allergens, categories, tags, image_base64
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/food) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_food",
    "arguments": {
  "action": "LIST_FOODS",
  "page": 1,
  "locale": "pl"
}
  }
}
MANAGEMENT management_supplement POST /_mcp/management/supplement

Dietary Supplement Catalog Manager

Odżywianie & Diety (Management)
Supplement AI Documentation & Live Examples

Full CRUD management for dietary supplements (`/_mcp/management/supplement`) including active ingredient dosages (`SupplementNutrientAssign`), categories, tags, and S3 media.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_SUPPLEMENTS Action: GET_CREATION_GUIDE, LIST_SUPPLEMENTS, GET_SUPPLEMENT, CREATE_SUPPLEMENT, UPDATE_SUPPLEMENT, DELETE_SUPPLEMENT, DEACTIVATE_SUPPLEMENT, LIST_NUTRIENTS, LIST_CATEGORIES, LIST_TAGS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Supplement key (supplement_key), name_pl/de/en, company, brand, form_type, dosage_recommendation, nutrients, categories, tags, image_base64
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/supplement) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_supplement",
    "arguments": {
  "action": "LIST_SUPPLEMENTS",
  "page": 1,
  "locale": "pl"
}
  }
}
MANAGEMENT management_medication POST /_mcp/management/medication

Medication & Drug-Food Interaction Manager

Clinical & Pharmacology (Management)
Medication AI Documentation & Live Examples

Full CRUD management for medications (`/_mcp/management/medication`) including ATC codes, dosage strength, contraindications, categories, tags, and S3 media.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_MEDICATIONS Action: GET_CREATION_GUIDE, LIST_MEDICATIONS, GET_MEDICATION, CREATE_MEDICATION, UPDATE_MEDICATION, DELETE_MEDICATION, DEACTIVATE_MEDICATION, LIST_CATEGORIES, LIST_TAGS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Medication key (medication_key), name_pl/de/en, atc_code, dosage_strength_pl, contraindications_pl, categories, tags, image_base64
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/medication) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_medication",
    "arguments": {
  "action": "LIST_MEDICATIONS",
  "page": 1,
  "locale": "pl"
}
  }
}
MANAGEMENT management_exercise POST /_mcp/management/exercise

Exercise & Biomechanics Catalog Manager

Fitness & Biomechanics (Management)
Exercise AI Documentation & Live Examples

Full CRUD management for exercises (`/_mcp/management/exercise`) including biomechanics instructions, METs, calories burned, difficulty level, categories, tags, and S3 media.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_EXERCISES Action: GET_CREATION_GUIDE, LIST_EXERCISES, GET_EXERCISE, CREATE_EXERCISE, UPDATE_EXERCISE, DELETE_EXERCISE, DEACTIVATE_EXERCISE, LIST_CATEGORIES, LIST_TAGS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Exercise key (exercise_key), name_pl/de/en, instruction_pl, mets, kcal_hour, level, categories, tags, image_base64
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/exercise) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_exercise",
    "arguments": {
  "action": "LIST_EXERCISES",
  "page": 1,
  "locale": "pl"
}
  }
}
MANAGEMENT management_exercise_bundle POST /_mcp/management/exercise-bundle

Exercise Bundle & Circuit Manager

Fitness & Biomechanics (Management)
Bundle AI Documentation & Live Examples

Full CRUD management for exercise bundles (`/_mcp/management/exercise-bundle`) including ADD_EXERCISE_TO_BUNDLE, UPDATE_EXERCISE_IN_BUNDLE, REMOVE_EXERCISE_FROM_BUNDLE, LIST_BUNDLE_TYPES, categories, tags, and S3 media.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_BUNDLES Action: GET_CREATION_GUIDE, LIST_BUNDLES, GET_BUNDLE, CREATE_BUNDLE, UPDATE_BUNDLE, DELETE_BUNDLE, DEACTIVATE_BUNDLE, ADD_EXERCISE_TO_BUNDLE, UPDATE_EXERCISE_IN_BUNDLE, REMOVE_EXERCISE_FROM_BUNDLE, LIST_BUNDLE_TYPES, LIST_CATEGORIES, LIST_TAGS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Bundle key (bundle_key), name_pl/de/en, exercises, assign_key, exercise_key, sets, reps, rest, categories, tags, image_base64
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/exercise-bundle) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_exercise_bundle",
    "arguments": {
  "action": "LIST_BUNDLES",
  "page": 1,
  "locale": "pl"
}
  }
}
MANAGEMENT management_allergen POST /_mcp/management/allergen

Food Allergen Catalog Manager

Clinical & Pharmacology (Management)
Allergen AI Documentation & Live Examples

Full CRUD management for food allergens (`/_mcp/management/allergen`) including localized descriptions, categories, tags, SEO metadata, and S3 media.

Tool Argument Schema
Argument Type Status Default Description
action string required LIST_ALLERGENS Action: GET_CREATION_GUIDE, LIST_ALLERGENS, GET_ALLERGEN, CREATE_ALLERGEN, UPDATE_ALLERGEN, DELETE_ALLERGEN, DEACTIVATE_ALLERGEN, LIST_CATEGORIES, LIST_TAGS, GET_MEDIA, ADD_MEDIA, REPLACE_MEDIA, DELETE_MEDIA
payload object optional {} Allergen key (allergen_key), name_pl/de/en, description_pl/de/en, categories, tags, image_base64
locale string optional pl Language locale
page integer optional 1 Page number (max 10 items per page)
max_results integer optional 10 Items per page (1-10)
JSON-RPC 2.0 tools/call Payload (/_mcp/management/allergen) 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "management_allergen",
    "arguments": {
  "action": "LIST_ALLERGENS",
  "page": 1,
  "locale": "pl"
}
  }
}
Interactive MCP Tools Explorer

Pełna Specyfikacja Narzędzi MCP

Zobacz pełny interaktywny katalog narzędzi MCP z podglądem parametrów i dynamicznym generatorem zapytań.

Otwórz Dokumentację Narzędzi MCP

Udostępnij