MCP-Tools & API Platform 5.0 Endpunkte
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://dietspremium.de/_mcp/management/patient
npx -y dietspremium-mcp
Eingabeparameter-Schema (inputSchema)
| Feldname | JSON-Typ | Status | Beschreibung | Beispielwert |
|---|---|---|---|---|
action
|
string | Erforderlich | 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 Aufruf (tools/call)
management_patientnpx -y dietspremium-mcp --url https://dietspremium.de/_mcp
curl -X POST https://dietspremium.de/_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"
}'
Antwortstruktur des MCP-Tools
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="de").
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 DE i zwróć ustrukturyzowane dane kliniczne.”
→ POST https://dietspremium.de/_mcp/management/patient (tool: "management_patient")
← 200 OK (5 zwalidowanych parametrów)