---
title: "Εργαλεία MCP για ασθενείς — HyperCRM"
description: "Τα δέκα εργαλεία MCP για φακέλους και σημειώσεις ασθενών: παράμετροι, παραδείγματα κλήσης, αποτελέσματα και σφάλματα, με τον ρόλο που απαιτεί καθένα."
canonical: "https://hypercrm.app/el/docs/mcp/patients"
lang: "el"
updated: "2026-07-26"
---

_Αναφορά MCP / Ασθενείς_

# Εργαλεία ασθενών

Δέκα εργαλεία για τον φάκελο του ασθενή, τις κλινικές σημειώσεις και τους υποπόρους του. Καθένα με τις παραμέτρους του, παράδειγμα κλήσης και το τι επιστρέφει.

[Ξεκινήστε δωρεάν δοκιμή](/dashboard) · [Και τα 60 εργαλεία](/el/docs/mcp/tools)

## Πώς διαβάζεται

Κάθε εργαλείο παρακάτω παραθέτει τις παραμέτρους του ακριβώς όπως τις δηλώνει το σχήμα εισόδου — τον τύπο, αν είναι υποχρεωτική, και τις επιτρεπτές τιμές όπου τις ορίζει το σχήμα. Δεν υπάρχουν περιγραφές παραμέτρων: τα σχήματα φέρουν τύπους, όχι κείμενο.

Το `practiceId` δεν είναι ποτέ παράμετρος. Προέρχεται από το token σας, και οι διαδρομές εγγραφής το αφαιρούν αν το στείλει ο client.

Κάθε παράδειγμα είναι πλήρες αίτημα `tools/call` με συμπληρωμένες τις υποχρεωτικές παραμέτρους. Τα σφάλματα επιστρέφονται μέσα σε απόκριση `200` με `isError` — δείτε την [επισκόπηση MCP](/el/docs/mcp) και τον [πλήρη κατάλογο](/el/docs/mcp/tools).

Ο φάκελος του ασθενή, οι σημειώσεις του και οι υποπόροι που κρέμονται από αυτόν.

### list_patients

_Μόνο ανάγνωση, Κάθε μέλος_

Λίστα ασθενών του ιατρείου, με προαιρετική αναζήτηση και φίλτρα κατάστασης και ετικέτας.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `search` | `string` | Προαιρετικό |
| `status` | `string` | Προαιρετικό |
| `tagId` | `string` | Προαιρετικό |
| `limit` | `integer` | Προαιρετικό |
| `offset` | `integer` | Προαιρετικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_patients",
    "arguments": {}
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### get_patient

_Μόνο ανάγνωση, Κάθε μέλος_

Ανάγνωση ενός ασθενή με βάση το id.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_patient",
    "arguments": {
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### list_patient_notes

_Μόνο ανάγνωση, Κάθε μέλος_

Λίστα όλων των κλινικών σημειώσεων ενός ασθενή.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_patient_notes",
    "arguments": {
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### list_patient_files

_Μόνο ανάγνωση, Κάθε μέλος_

Λίστα αρχείων ασθενή. Χρησιμοποιήστε το get_file για σύνδεσμο λήψης.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_patient_files",
    "arguments": {
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### list_patient_billing_entries

_Μόνο ανάγνωση, Κάθε μέλος_

Λίστα των χρεώσεων που έχουν καταγραφεί για έναν ασθενή, μαζί με το υπόλοιπο: τι οφείλει τώρα, το ίδιο ποσό με το καθολικό στη σελίδα του ασθενή. Χρησιμοποιήστε αυτό αντί να αθροίζετε εγγραφές. Μια εγγραφή receipt είναι είσπραξη, όχι παραστατικό.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_patient_billing_entries",
    "arguments": {
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### list_patient_invoices

_Μόνο ανάγνωση, Κάθε μέλος_

Λίστα των αποδείξεων και τιμολογίων που έχουν εκδοθεί για έναν ασθενή.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_patient_invoices",
    "arguments": {
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### get_patient_invoice_preview

_Μόνο ανάγνωση, Κάθε μέλος_

Υπολογισμός προσχεδίου απόδειξης ή τιμολογίου για τις μη χρεωμένες εγγραφές, χωρίς έκδοση. Για έκδοση χρησιμοποιήστε write_invoice με action=issue.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_patient_invoice_preview",
    "arguments": {
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the requested records" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### write_patient

_Γράφει, Μπορεί να διαγράψει, Κάθε μέλος_

Δημιουργία, ενημέρωση ή διαγραφή ασθενή. action=create απαιτεί firstName και lastName· update και delete απαιτούν patientId. Η διαγραφή είναι μόνιμη.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `action` | `create` \\| `update` \\| `delete` | Υποχρεωτικό |
| `patientId` | `string` | Προαιρετικό |
| `firstName` | `string` | Προαιρετικό |
| `lastName` | `string` | Προαιρετικό |
| `dob` | `string` | Προαιρετικό |
| `gender` | `string` | Προαιρετικό |
| `email` | `string` | Προαιρετικό |
| `phoneMobile` | `string` | Προαιρετικό |
| `address` | `string` | Προαιρετικό |
| `postcode` | `string` | Προαιρετικό |
| `country` | `string` | Προαιρετικό |
| `taxId` | `string` | Προαιρετικό |
| `taxOffice` | `string` | Προαιρετικό |
| `status` | `string` | Προαιρετικό |
| `notifyByEmail` | `boolean` | Προαιρετικό |
| `notifyBySms` | `boolean` | Προαιρετικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_patient",
    "arguments": {
      "action": "create"
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the written record" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### write_patient_note

_Γράφει, Μπορεί να διαγράψει, Κάθε μέλος_

Δημιουργία, ενημέρωση ή διαγραφή σημείωσης ασθενή. action=create απαιτεί body· update και delete απαιτούν noteId.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `action` | `create` \\| `update` \\| `delete` | Υποχρεωτικό |
| `patientId` | `string` | Υποχρεωτικό |
| `noteId` | `string` | Προαιρετικό |
| `title` | `string` | Προαιρετικό |
| `body` | `string` | Προαιρετικό |
| `isNext` | `boolean` | Προαιρετικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "write_patient_note",
    "arguments": {
      "action": "create",
      "patientId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the written record" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

### toggle_patient_tag

_Γράφει, Κάθε μέλος_

Προσθέτει την ετικέτα αν λείπει, την αφαιρεί αν υπάρχει ήδη.

**Παράμετροι**

| Εργαλείο | Τύπος | Υποχρεωτικό; |
| --- | --- | --- |
| `patientId` | `string` | Υποχρεωτικό |
| `tagId` | `string` | Υποχρεωτικό |

**Παράδειγμα κλήσης**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "toggle_patient_tag",
    "arguments": {
      "patientId": "0f1c7a2e-....",
      "tagId": "0f1c7a2e-...."
    }
  }
}
```

**Αποτέλεσμα**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "status": 200,
      "ok": true,
      "data": { "...": "the written record" }
    }
  }
}
```

**Σφάλματα**

| Κωδικός | Κατάσταση | Πότε |
| --- | --- | --- |
| `validation_failed` | 400 | Λείπει παράμετρος, έχει λάθος τύπο, ή είναι εκτός των επιτρεπτών τιμών. |
| `not_found` | 404 | Το id δεν υπάρχει στο ιατρείο σας. Ένα κακοσχηματισμένο id φαίνεται ίδιο. |
| `unauthorized` | 401 | Το bearer token λείπει, είναι άκυρο ή έχει λήξει. |

## Συχνές ερωτήσεις

### Πώς προστατεύονται τα δεδομένα των ασθενών;

Τα αρχεία ασθενών κρυπτογραφούνται κατά τη μεταφορά και την αποθήκευση, τα αρχεία φυλάσσονται ιδιωτικά και σερβίρονται μέσω συνδέσμων περιορισμένης διάρκειας, ενώ κάθε αλλαγή καταγράφεται. Το προσωπικό συνδέεται με passkeys αντί για κοινούς κωδικούς.

### Μπορώ να εξάγω τα δεδομένα μου;

Ναι. Κάθε λίστα στο HyperCRM εξάγεται σε CSV μέσα από την εφαρμογή και τα αρχεία σας μπορούν να κατέβουν οποιαδήποτε στιγμή. Τα δεδομένα του ιατρείου σας ανήκουν σε εσάς, χωρίς χρέωση ή καθυστέρηση εξαγωγής — και στα δύο πακέτα, στη δοκιμή, αλλά και μετά την ακύρωση.

### Πόσο κοστίζει το HyperCRM;

Το HyperCRM είναι λογισμικό επί πληρωμή. Κάθε ιατρείο ξεκινά με δωρεάν δοκιμή 30 ημερών στο πλήρες πακέτο Complete, χωρίς κάρτα. Στη συνέχεια τα πακέτα ξεκινούν από 19 € και 29 € τον μήνα χωρίς ΦΠΑ, σε κλιμάκια ανάλογα με το πόσους επαγγελματίες υγείας απασχολείτε. Κάθε τιμή δημοσιεύεται στη σελίδα τιμών, ποτέ σε τηλεφωνική πώληση.