MCP Tools & API Platform 5.0 Endpoints
Patient & Client CRM (List, Add, Edit, Soft-Deactivate)
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).
management_patient
https://www.dietspremium.com/_mcp/management/patient
npx -y dietspremium-mcp
Input Parameters Schema (inputSchema)
| Field name | JSON Type | Status | Description | Example value |
|---|---|---|---|---|
action
|
string | Required | 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 | LIST_PATIENTS
|
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 | Language locale | pl
|
page
|
integer | Optional | Page number (max 10 items per page) | 1
|
max_results
|
integer | Optional | Items per page (1-10) | 10
|
JSON-RPC 2.0 Request (tools/call)
management_patientnpx -y dietspremium-mcp --url https://www.dietspremium.com/_mcp
curl -X POST https://www.dietspremium.com/_mcp/management/patient \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_MCP_KEY" \
-d '{
"action": "LIST_PATIENTS",
"page": 1,
"max_results": 10,
"locale": "pl"
}'
MCP Tool Response Structure
application/json • UTF-8{
"status": "success",
"items": [
{
"patient_key": "OTAx",
"firstname": "Marek",
"lastname": "Nowak",
"active": 1
}
],
"page": 1
}
Kroki wykonania dla management_patient
MCP Flow
Instrukcja integracji dla programistów i agentów AI
Instrukcja integracji dla programistów i agentów AI
management_patient
Przekaż parametry zgodne z tabelą obok (np. locale="en").
McpKeyCodec
Każdy zwrócony rekord posiada pole "key" (Base64), które można bezpiecznie przekazać do narzędzi management_*.
Specjalizowany Agent dla narzędzia management_patient
“Wykonaj zapytanie do narzędzia management_patient dla języka EN i zwróć ustrukturyzowane dane kliniczne.”
→ POST https://www.dietspremium.com/_mcp/management/patient (tool: "management_patient")
← 200 OK (5 zwalidowanych parametrów)