MCP Server

DoctoFam Medical Clinic

com.doctofam/doctofam
Business & Operations Healthcare Public & reachable MCP 2025-11-25

What this MCP does

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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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'}}}
Output schema
{'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}
Changed
show_clinic_overview
Sept. 29, 2026, 2:48 a.m.
Changed
get_subscription_status
Sept. 29, 2026, 2:48 a.m.
Changed
get_clinic_availability
Sept. 29, 2026, 2:48 a.m.
Changed
list_providers
Sept. 29, 2026, 2:48 a.m.
Changed
list_calendar_events
Sept. 29, 2026, 2:48 a.m.
Changed
list_rooms
Sept. 29, 2026, 2:48 a.m.
Changed
list_procedures
Sept. 29, 2026, 2:48 a.m.
Changed
get_clinic_schedule_summary
Sept. 29, 2026, 2:48 a.m.
Changed
get_clinic
Sept. 29, 2026, 2:48 a.m.
Changed
list_clinics
Sept. 29, 2026, 2:48 a.m.
Added
show_clinic_overview
Sept. 27, 2026, 2:40 a.m.
Added
get_subscription_status
Sept. 27, 2026, 2:40 a.m.
Added
get_clinic_availability
Sept. 27, 2026, 2:40 a.m.
Added
list_providers
Sept. 27, 2026, 2:40 a.m.
Added
list_calendar_events
Sept. 27, 2026, 2:40 a.m.
Added
list_rooms
Sept. 27, 2026, 2:40 a.m.
Added
list_procedures
Sept. 27, 2026, 2:40 a.m.
Added
get_clinic_schedule_summary
Sept. 27, 2026, 2:40 a.m.
Added
get_clinic
Sept. 27, 2026, 2:40 a.m.
Added
list_clinics
Sept. 27, 2026, 2:40 a.m.