MCP-Server

DoctoFam Medical Clinic

com.doctofam/doctofam
Business & Betrieb Gesundheitswesen Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Provides read-only clinic availability, providers, rooms, procedure catalogs, calendar blocks, and aggregate administrative schedules.

get_clinic
Get medical practice details
Use this when someone asks about one medical practice's setup, such as its currency, language or timezone. Returns the practice's name, currency, default language, timezone and last edit time. Not for free consultation times.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinicId'], 'properties': {'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'clinic'], 'properties': {'clinic': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'currency', 'defaultLocale', 'timezone', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, {'type': 'null'}]}, 'timezone': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 35}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Administrative practice metadata only; opening hours, staff, patient and appointment data are not included. Null when not found.'}, 'status': {'enum': ['found', 'not-found'], 'type': 'string'}}, 'additionalProperties': False}
get_clinic_availability
Find free consultation times
Use this when someone asks when their doctor's practice has free appointment or consultation times. Returns each open online-booking slot's start and end, grouped by day, for the next days with openings: up to 7 days and 100 slots (no patient or doctor details). Not for booking a visit.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinicId'], 'properties': {'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['days'], 'properties': {'days': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'slots'], 'properties': {'day': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'slots': {'type': 'array', 'items': {'type': 'object', 'required': ['startTime', 'endTime'], 'properties': {'endTime': {'$ref': '#/properties/days/items/properties/slots/items/properties/startTime'}, 'startTime': {'type': 'string', 'maxLength': 32}}, 'additionalProperties': False}, 'maxItems': 100}}, 'additionalProperties': False}, 'maxItems': 7, 'description': 'One row per day with open online-booking slots, in date order, holding at most 100 slots in total. Slot times only; patients, doctors, services and clinical data are never included.'}}, 'additionalProperties': False}
get_clinic_schedule_summary
Count patient visits per day
Use this when someone asks how busy their medical practice is or how many patient visits are booked each day. Returns appointment counts per UTC day for one practice, whatever their status, for the next 7 days by default and at most 31 days; counting stops at 100. Not for counting cancellations or seeing which patients are booked.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinicId'], 'properties': {'endTime': {'$ref': '#/properties/startTime', 'description': 'End of the range as an ISO 8601 date-time, after startTime and at most 31 days later; defaults to 7 days after the start'}, 'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}, 'startTime': {'type': 'string', 'maxLength': 32, 'description': 'Start of the range as an ISO 8601 date-time; defaults to now'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['range', 'appointmentCount', 'appointmentCountIsLowerBound', 'days'], 'properties': {'days': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'appointmentCount'], 'properties': {'day': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'appointmentCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'One row per UTC day that has appointments, canceled ones included. Aggregate counts only: appointment identifiers and times, patient information, services, diagnoses and notes are never returned.'}, 'range': {'type': 'object', 'required': ['startTime', 'endTime'], 'properties': {'endTime': {'$ref': '#/properties/range/properties/startTime'}, 'startTime': {'type': 'string', 'maxLength': 32}}, 'additionalProperties': False}, 'appointmentCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'appointmentCountIsLowerBound': {'type': 'boolean', 'description': 'True when more than 100 appointments fall in the range'}}, 'additionalProperties': False}
get_subscription_status
Check DoctoFam plan and limits
Use this when someone asks which DoctoFam plan a practice is on, whether it is active, or how many appointments, patients, rooms or users it allows. Returns the plan name, status, billing frequency and plan caps, or the default Free plan when none is active. Not for invoices or amounts billed.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinicId'], 'properties': {'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subscription'], 'properties': {'subscription': {'type': 'object', 'required': ['status', 'productName', 'billingFrequency', 'maxNumberOfAppointments', 'maxNumberOfPatients', 'maxNumberOfSeats', 'maxNumberOfUsers', 'lastEditTime', 'isDefaultFreePlan'], 'properties': {'status': {'anyOf': [{'enum': ['ACTIVE', 'PAST_DUE', 'CANCELED'], 'type': 'string'}, {'type': 'null'}]}, 'productName': {'type': 'string', 'maxLength': 200}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'billingFrequency': {'anyOf': [{'enum': ['MONTHLY', 'YEARLY'], 'type': 'string'}, {'type': 'null'}]}, 'maxNumberOfSeats': {'$ref': '#/properties/subscription/properties/maxNumberOfAppointments'}, 'maxNumberOfUsers': {'$ref': '#/properties/subscription/properties/maxNumberOfAppointments'}, 'isDefaultFreePlan': {'type': 'boolean'}, 'maxNumberOfPatients': {'$ref': '#/properties/subscription/properties/maxNumberOfAppointments'}, 'maxNumberOfAppointments': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}}, 'description': "The practice's active or past-due plan, or the default Free plan (isDefaultFreePlan) when neither exists. Seats are rooms; caps are limits, not usage. Billing identifiers, payment-provider data, amounts, currencies, patient records and clinical data are never returned.", 'additionalProperties': False}}, 'additionalProperties': False}
list_calendar_events
List closures, holidays and blocked time
Use this when someone asks when their medical practice is closed, or when a doctor or room is blocked for holidays, sick leave, courses, meetings or maintenance. Returns each block or extra opening with start, end, all-day flag, scope and type (no titles or notes). Not for patient appointments.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Blocks per page, from 1 to 100; defaults to 20', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'endTime': {'$ref': '#/properties/startTime', 'description': 'Only blocks ending before this ISO 8601 date-time'}, 'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Only this practice (24 lowercase hexadecimal characters); every practice when absent'}, 'startTime': {'type': 'string', 'maxLength': 32, 'description': 'Only blocks starting at or after this ISO 8601 date-time'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['calendarEvents', 'nextCursor'], 'properties': {'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'calendarEvents': {'type': 'array', 'items': {'type': 'object', 'required': ['startTime', 'endTime', 'allDay', 'scope', 'effect', 'type'], 'properties': {'type': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}], 'description': 'Label such as COURSE, MEETING, VACATION, SICK, HOLIDAY, MAINTENANCE or OTHER'}, 'scope': {'anyOf': [{'enum': ['SEAT', 'PROVIDER', 'CLINIC'], 'type': 'string'}, {'type': 'null'}], 'description': 'CLINIC: the whole practice; PROVIDER: one or more staff; SEAT: one room'}, 'allDay': {'type': 'boolean'}, 'effect': {'anyOf': [{'enum': ['BLOCK', 'OPEN'], 'type': 'string'}, {'type': 'null'}], 'description': 'BLOCK removes bookable time; OPEN adds hours on a normally closed time'}, 'endTime': {'anyOf': [{'$ref': '#/properties/calendarEvents/items/properties/startTime/anyOf/0'}, {'type': 'null'}]}, 'startTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Non-appointment calendar blocks, earliest first. Event identifiers, staff and room references, titles, notes and patient links are never returned.'}}, 'additionalProperties': False}
list_clinics
List your medical practices
Use this when someone asks which medical practices or doctor's offices they run in DoctoFam, or a practice's id is needed. Returns each practice's id, name, currency, default language and timezone, 20 per page by default. Not for finding a patient or a visit.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Practices per page, from 1 to 100; defaults to 20', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page of this listing; absent for the first page'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinics', 'nextCursor'], 'properties': {'clinics': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'currency', 'defaultLocale', 'timezone', 'lastEditTime'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, {'type': 'null'}]}, 'timezone': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 35}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Medical practices in the signed-in organization, administrative metadata only. Patient, appointment and clinical records are never returned.'}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}}, 'additionalProperties': False}
list_procedures
Look up consultation and service prices
Use this when someone asks what their medical practice charges for a consultation, check-up, vaccination or other service. Returns catalog service names with price and last edit time, alphabetically, 50 per page by default. Not for a patient's medical history or the care they received.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Services per page, from 1 to 100; defaults to 50', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Only this practice (24 lowercase hexadecimal characters); every practice when absent'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['procedures', 'nextCursor'], 'properties': {'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}, 'procedures': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'price', 'duration', 'lastEditTime'], 'properties': {'name': {'type': 'string', 'maxLength': 200}, 'price': {'type': ['number', 'null'], 'description': "Price in the practice's currency"}, 'duration': {'type': ['number', 'null'], 'description': 'Configured duration, or null when none was recorded'}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Service catalog entries in name order. Patient-linked treatments, diagnoses, prescriptions and record identifiers are never returned.'}}, 'additionalProperties': False}
list_providers
List doctors and staff who take bookings
Use this when someone asks which doctors, nurses or assistants patients can book at their practice. Returns up to 100 staff display names for one practice (no contact details or roles). Not for staff holidays or sick days.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinicId'], 'properties': {'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['providers'], 'properties': {'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['displayName'], 'properties': {'displayName': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Display names of staff with a doctor, nurse or assistant role. Staff identifiers, contact details, role records and clinical data are never returned.'}}, 'additionalProperties': False}
list_rooms
List consultation rooms
Use this when someone asks which consultation or exam rooms their medical practice has. Returns room names with last edit time for one practice, alphabetically, 50 per page by default. Not for room schedules or which patient uses a room.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['clinicId'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Rooms per page, from 1 to 100; defaults to 50', 'exclusiveMinimum': 0}, 'cursor': {'type': 'string', 'maxLength': 4096, 'description': 'The nextCursor of the previous page with the same filters; absent for the first page'}, 'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rooms', 'nextCursor'], 'properties': {'rooms': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'lastEditTime'], 'properties': {'name': {'type': 'string', 'maxLength': 200}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 100, 'description': 'Rooms in name order. Record identifiers, appointment links, patient information and clinical content are never returned.'}, 'nextCursor': {'anyOf': [{'type': 'string', 'maxLength': 4096}, {'type': 'null'}], 'description': 'Cursor for the next page; null on the last page'}}, 'additionalProperties': False}
show_clinic_overview
Show medical practice overview
Use this when someone wants a quick overview or dashboard of one medical practice. Returns an overview card with the practice's details, appointment counts for the next 7 days, staff and room counts, open online-booking slots, up to 12 service prices and the current plan (no patient or clinical data). Not for a single patient or visit.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['clinicId'], 'properties': {'clinicId': {'type': 'string', 'pattern': '^[0-9a-f]{24}$', 'description': 'Practice id: 24 lowercase hexadecimal characters'}}}
Ausgabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['clinic', 'scheduleRange', 'appointmentCount', 'appointmentCountIsLowerBound', 'scheduleDays', 'procedureCount', 'procedureCountIsLowerBound', 'procedures', 'providerCount', 'providerCountIsLowerBound', 'roomCount', 'roomCountIsLowerBound', 'availableDayCount', 'availableSlotCount', 'availabilityDays', 'subscription'], 'properties': {'clinic': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'currency', 'defaultLocale', 'timezone'], 'properties': {'id': {'type': 'string', 'pattern': '^[0-9a-f]{24}$'}, 'name': {'type': 'string', 'maxLength': 200}, 'currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, {'type': 'null'}]}, 'timezone': {'anyOf': [{'type': 'string', 'maxLength': 64}, {'type': 'null'}]}, 'defaultLocale': {'anyOf': [{'type': 'string', 'maxLength': 35}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}], 'description': 'Administrative practice metadata; null when the practice was not found. The overview never includes individual appointment records, patient information, diagnoses, treatment details, notes or other clinical data.'}, 'roomCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'procedures': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'price', 'duration', 'lastEditTime'], 'properties': {'name': {'type': 'string', 'maxLength': 200}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'duration': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lastEditTime': {'anyOf': [{'type': 'string', 'maxLength': 32}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 12}, 'scheduleDays': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'count'], 'properties': {'day': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 100}, 'subscription': {'anyOf': [{'type': 'object', 'required': ['status', 'productName', 'billingFrequency', 'maxNumberOfAppointments', 'maxNumberOfPatients', 'maxNumberOfSeats', 'maxNumberOfUsers', 'isDefaultFreePlan'], 'properties': {'status': {'anyOf': [{'enum': ['ACTIVE', 'PAST_DUE', 'CANCELED'], 'type': 'string'}, {'type': 'null'}]}, 'productName': {'type': 'string', 'maxLength': 200}, 'billingFrequency': {'anyOf': [{'enum': ['MONTHLY', 'YEARLY'], 'type': 'string'}, {'type': 'null'}]}, 'maxNumberOfSeats': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'maxNumberOfUsers': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'isDefaultFreePlan': {'type': 'boolean'}, 'maxNumberOfPatients': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'maxNumberOfAppointments': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'providerCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'scheduleRange': {'type': 'object', 'required': ['startTime', 'endTime'], 'properties': {'endTime': {'type': 'string', 'maxLength': 32}, 'startTime': {'type': 'string', 'maxLength': 32}}, 'additionalProperties': False}, 'procedureCount': {'type': 'integer', 'maximum': 12, 'minimum': 0}, 'appointmentCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'availabilityDays': {'type': 'array', 'items': {'type': 'object', 'required': ['day', 'count'], 'properties': {'day': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, 'count': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 7}, 'availableDayCount': {'type': 'integer', 'maximum': 7, 'minimum': 0}, 'availableSlotCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'roomCountIsLowerBound': {'type': 'boolean'}, 'providerCountIsLowerBound': {'type': 'boolean'}, 'procedureCountIsLowerBound': {'type': 'boolean'}, 'appointmentCountIsLowerBound': {'type': 'boolean'}}, 'additionalProperties': False}
Geändert
show_clinic_overview
29. September 2026 02:48
Geändert
get_subscription_status
29. September 2026 02:48
Geändert
get_clinic_availability
29. September 2026 02:48
Geändert
list_providers
29. September 2026 02:48
Geändert
list_calendar_events
29. September 2026 02:48
Geändert
list_rooms
29. September 2026 02:48
Geändert
list_procedures
29. September 2026 02:48
Geändert
get_clinic_schedule_summary
29. September 2026 02:48
Geändert
get_clinic
29. September 2026 02:48
Geändert
list_clinics
29. September 2026 02:48
Hinzugefügt
show_clinic_overview
27. September 2026 02:40
Hinzugefügt
get_subscription_status
27. September 2026 02:40
Hinzugefügt
get_clinic_availability
27. September 2026 02:40
Hinzugefügt
list_providers
27. September 2026 02:40
Hinzugefügt
list_calendar_events
27. September 2026 02:40
Hinzugefügt
list_rooms
27. September 2026 02:40
Hinzugefügt
list_procedures
27. September 2026 02:40
Hinzugefügt
get_clinic_schedule_summary
27. September 2026 02:40
Hinzugefügt
get_clinic
27. September 2026 02:40
Hinzugefügt
list_clinics
27. September 2026 02:40