DoctoFam Medical Clinic
See your clinic's free slots, doctors, rooms, service prices and how busy each day is.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"doctofam": {
"url": "https://mcp.doctofam.com/mcp"
}
}
}원격 엔드포인트
https://mcp.doctofam.com/mcpstreamable-http할 수 있는 일
도구 목록
도구 (10)
🟢list_clinics(limit, cursor)
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.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Practices per page, from 1 to 100; defaults to 20"
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The nextCursor of the previous page of this listing; absent for the first page"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"clinics": {
"type": "array",
"items": {
"type": "object",
"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"
}
]
},
"defaultLocale": {
"anyOf": [
{
"type": "string",
"maxLength": 35
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
]
},
"lastEditTime": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"currency",
"defaultLocale",
"timezone",
"lastEditTime"
],
"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"
}
},
"required": [
"clinics",
"nextCursor"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_clinic(clinicId)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Practice id: 24 lowercase hexadecimal characters"
}
},
"required": [
"clinicId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"found",
"not-found"
]
},
"clinic": {
"anyOf": [
{
"type": "object",
"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"
}
]
},
"defaultLocale": {
"anyOf": [
{
"type": "string",
"maxLength": 35
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
]
},
"lastEditTime": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"currency",
"defaultLocale",
"timezone",
"lastEditTime"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Administrative practice metadata only; opening hours, staff, patient and appointment data are not included. Null when not found."
}
},
"required": [
"status",
"clinic"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_clinic_schedule_summary(clinicId, startTime, endTime)
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.
입력 스키마
{
"type": "object",
"properties": {
"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"
},
"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"
}
},
"required": [
"clinicId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"range": {
"type": "object",
"properties": {
"startTime": {
"type": "string",
"maxLength": 32
},
"endTime": {
"$ref": "#/properties/range/properties/startTime"
}
},
"required": [
"startTime",
"endTime"
],
"additionalProperties": false
},
"appointmentCount": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"appointmentCountIsLowerBound": {
"type": "boolean",
"description": "True when more than 100 appointments fall in the range"
},
"days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"appointmentCount": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"day",
"appointmentCount"
],
"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."
}
},
"required": [
"range",
"appointmentCount",
"appointmentCountIsLowerBound",
"days"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_procedures(clinicId, limit, cursor)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Only this practice (24 lowercase hexadecimal characters); every practice when absent"
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Services per page, from 1 to 100; defaults to 50"
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The nextCursor of the previous page with the same filters; absent for the first page"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"procedures": {
"type": "array",
"items": {
"type": "object",
"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"
}
]
}
},
"required": [
"name",
"price",
"duration",
"lastEditTime"
],
"additionalProperties": false
},
"maxItems": 100,
"description": "Service catalog entries in name order. Patient-linked treatments, diagnoses, prescriptions and record identifiers are never returned."
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"maxLength": 4096
},
{
"type": "null"
}
],
"description": "Cursor for the next page; null on the last page"
}
},
"required": [
"procedures",
"nextCursor"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_rooms(clinicId, limit, cursor)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Practice id: 24 lowercase hexadecimal characters"
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Rooms per page, from 1 to 100; defaults to 50"
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The nextCursor of the previous page with the same filters; absent for the first page"
}
},
"required": [
"clinicId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"rooms": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"lastEditTime": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"lastEditTime"
],
"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"
}
},
"required": [
"rooms",
"nextCursor"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_calendar_events(clinicId, startTime, endTime, limit, cursor)
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.
입력 스키마
{
"type": "object",
"properties": {
"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"
},
"endTime": {
"$ref": "#/properties/startTime",
"description": "Only blocks ending before this ISO 8601 date-time"
},
"limit": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Blocks per page, from 1 to 100; defaults to 20"
},
"cursor": {
"type": "string",
"maxLength": 4096,
"description": "The nextCursor of the previous page with the same filters; absent for the first page"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"calendarEvents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"startTime": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"endTime": {
"anyOf": [
{
"$ref": "#/properties/calendarEvents/items/properties/startTime/anyOf/0"
},
{
"type": "null"
}
]
},
"allDay": {
"type": "boolean"
},
"scope": {
"anyOf": [
{
"type": "string",
"enum": [
"SEAT",
"PROVIDER",
"CLINIC"
]
},
{
"type": "null"
}
],
"description": "CLINIC: the whole practice; PROVIDER: one or more staff; SEAT: one room"
},
"effect": {
"anyOf": [
{
"type": "string",
"enum": [
"BLOCK",
"OPEN"
]
},
{
"type": "null"
}
],
"description": "BLOCK removes bookable time; OPEN adds hours on a normally closed time"
},
"type": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
],
"description": "Label such as COURSE, MEETING, VACATION, SICK, HOLIDAY, MAINTENANCE or OTHER"
}
},
"required": [
"startTime",
"endTime",
"allDay",
"scope",
"effect",
"type"
],
"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."
},
"nextCursor": {
"anyOf": [
{
"type": "string",
"maxLength": 4096
},
{
"type": "null"
}
],
"description": "Cursor for the next page; null on the last page"
}
},
"required": [
"calendarEvents",
"nextCursor"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_providers(clinicId)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Practice id: 24 lowercase hexadecimal characters"
}
},
"required": [
"clinicId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"providers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"displayName": {
"type": "string",
"maxLength": 200
}
},
"required": [
"displayName"
],
"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."
}
},
"required": [
"providers"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_clinic_availability(clinicId)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Practice id: 24 lowercase hexadecimal characters"
}
},
"required": [
"clinicId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"slots": {
"type": "array",
"items": {
"type": "object",
"properties": {
"startTime": {
"type": "string",
"maxLength": 32
},
"endTime": {
"$ref": "#/properties/days/items/properties/slots/items/properties/startTime"
}
},
"required": [
"startTime",
"endTime"
],
"additionalProperties": false
},
"maxItems": 100
}
},
"required": [
"day",
"slots"
],
"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."
}
},
"required": [
"days"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_subscription_status(clinicId)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Practice id: 24 lowercase hexadecimal characters"
}
},
"required": [
"clinicId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"type": "object",
"properties": {
"subscription": {
"type": "object",
"properties": {
"status": {
"anyOf": [
{
"type": "string",
"enum": [
"ACTIVE",
"PAST_DUE",
"CANCELED"
]
},
{
"type": "null"
}
]
},
"productName": {
"type": "string",
"maxLength": 200
},
"billingFrequency": {
"anyOf": [
{
"type": "string",
"enum": [
"MONTHLY",
"YEARLY"
]
},
{
"type": "null"
}
]
},
"maxNumberOfAppointments": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maxNumberOfPatients": {
"$ref": "#/properties/subscription/properties/maxNumberOfAppointments"
},
"maxNumberOfSeats": {
"$ref": "#/properties/subscription/properties/maxNumberOfAppointments"
},
"maxNumberOfUsers": {
"$ref": "#/properties/subscription/properties/maxNumberOfAppointments"
},
"lastEditTime": {
"anyOf": [
{
"type": "string",
"maxLength": 32
},
{
"type": "null"
}
]
},
"isDefaultFreePlan": {
"type": "boolean"
}
},
"required": [
"status",
"productName",
"billingFrequency",
"maxNumberOfAppointments",
"maxNumberOfPatients",
"maxNumberOfSeats",
"maxNumberOfUsers",
"lastEditTime",
"isDefaultFreePlan"
],
"additionalProperties": false,
"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."
}
},
"required": [
"subscription"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_clinic_overview(clinicId)
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.
입력 스키마
{
"type": "object",
"properties": {
"clinicId": {
"type": "string",
"pattern": "^[0-9a-f]{24}$",
"description": "Practice id: 24 lowercase hexadecimal characters"
}
},
"required": [
"clinicId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}출력 스키마
{
"type": "object",
"properties": {
"clinic": {
"anyOf": [
{
"type": "object",
"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"
}
]
},
"defaultLocale": {
"anyOf": [
{
"type": "string",
"maxLength": 35
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"currency",
"defaultLocale",
"timezone"
],
"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."
},
"scheduleRange": {
"type": "object",
"properties": {
"startTime": {
"type": "string",
"maxLength": 32
},
"endTime": {
"type": "string",
"maxLength": 32
}
},
"required": [
"startTime",
"endTime"
],
"additionalProperties": false
},
"appointmentCount": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"appointmentCountIsLowerBound": {
"type": "boolean"
},
"scheduleDays": {
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"day",
"count"
],
"additionalProperties": false
}
},
"procedureCount": {
"type": "integer",
"minimum": 0,
"maximum": 12
},
"procedureCountIsLowerBound": {
"type": "boolean"
},
"procedures": {
"maxItems": 12,
"type": "array",
"items": {
"type": "object",
"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"
}
]
}
},
"required": [
"name",
"price",
"duration",
"lastEditTime"
],
"additionalProperties": false
}
},
"providerCount": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"providerCountIsLowerBound": {
"type": "boolean"
},
"roomCount": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"roomCountIsLowerBound": {
"type": "boolean"
},
"availableDayCount": {
"type": "integer",
"minimum": 0,
"maximum": 7
},
"availableSlotCount": {
"type": "integer",
"minimum": 0,
"maximum": 100
},
"availabilityDays": {
"maxItems": 7,
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 100
}
},
"required": [
"day",
"count"
],
"additionalProperties": false
}
},
"subscription": {
"anyOf": [
{
"type": "object",
"properties": {
"status": {
"anyOf": [
{
"type": "string",
"enum": [
"ACTIVE",
"PAST_DUE",
"CANCELED"
]
},
{
"type": "null"
}
]
},
"productName": {
"type": "string",
"maxLength": 200
},
"billingFrequency": {
"anyOf": [
{
"type": "string",
"enum": [
"MONTHLY",
"YEARLY"
]
},
{
"type": "null"
}
]
},
"maxNumberOfAppointments": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maxNumberOfPatients": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maxNumberOfSeats": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"maxNumberOfUsers": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"isDefaultFreePlan": {
"type": "boolean"
}
},
"required": [
"status",
"productName",
"billingFrequency",
"maxNumberOfAppointments",
"maxNumberOfPatients",
"maxNumberOfSeats",
"maxNumberOfUsers",
"isDefaultFreePlan"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"clinic",
"scheduleRange",
"appointmentCount",
"appointmentCountIsLowerBound",
"scheduleDays",
"procedureCount",
"procedureCountIsLowerBound",
"procedures",
"providerCount",
"providerCountIsLowerBound",
"roomCount",
"roomCountIsLowerBound",
"availableDayCount",
"availableSlotCount",
"availabilityDays",
"subscription"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}커뮤니티
증거