Open Dental MCP by usefulapi
Read appointments, open slots, providers, procedure codes and recalls in Open Dental.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (3)
- LOWTool 'opendental_list_asap_appointments' name length outside 3-30 rangein opendental_list_asap_appointments
- LOWTool 'opendental_list_appointment_types' name length outside 3-30 rangein opendental_list_appointment_types
- LOWTool 'opendental_list_procedure_codes' name length outside 3-30 rangein opendental_list_procedure_codes
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"open-dental": {
"url": "https://open-dental.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://open-dental.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (17)
🟢opendental_get_api_permissions
The API permissions this customer key has (ReadAll, Appointments, Patients, ...), each true or false. The tools here only read, so ReadAll is the one they need. Use it to explain why a call is refused. GET /securityperms.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_patients(last_name, first_name, status, birthdate, guarantor, ...)
List patients with the fast search (name, birthdate, status, guarantor, primary provider, clinic, changed since). Names match partially, case-insensitive. Returns demographics, balances and contact data (protected health information); SSNs are removed. Page with limit/offset. GET /patients/Simple.
Eingabe-Schema
{
"type": "object",
"properties": {
"last_name": {
"description": "Last name or the start of it.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"first_name": {
"description": "First name or the start of it.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"status": {
"description": "Patient status. Omit for all.",
"type": "string",
"enum": [
"Patient",
"NonPatient",
"Inactive",
"Archived",
"Deceased",
"Prospective"
]
},
"birthdate": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"guarantor": {
"description": "PatNum of the guarantor (the person responsible for the account): lists a family.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"primary_provider": {
"description": "ProvNum of the primary provider.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"clinic": {
"description": "ClinicNum. Omit for all clinics.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_search_patients(last_name, first_name, phone, email, address, ...)
Search patients the way Open Dental's Patient Select window does: by name, phone, email, address, city, state, chart number, birthdate or insurance subscriber id. Slower than opendental_list_patients on large databases; use it for phone, email and address lookups. Returns the Patient Select columns only (use opendental_get_patient for the full record). GET /patients.
Eingabe-Schema
{
"type": "object",
"properties": {
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"phone": {
"description": "Any of the patient's phone numbers.",
"type": "string",
"minLength": 1,
"maxLength": 30
},
"email": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"state": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"chart_number": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"birthdate": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"subscriber_id": {
"description": "Insurance subscriber id.",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"hide_inactive": {
"description": "Hide inactive patients.",
"type": "boolean"
},
"guarantors_only": {
"description": "Only guarantors.",
"type": "boolean"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_get_patient(patient_id)
One patient's full record by PatNum: name, status, birthdate, contact details, balances, providers, preferred contact methods, urgent notes. SSN is removed. GET /patients/{PatNum}.
Eingabe-Schema
{
"type": "object",
"properties": {
"patient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "PatNum."
}
},
"required": [
"patient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_get_patient_notes(patient_id)
A patient's note fields: family financial, medical, service, medical complete, treatment (odontogram) notes and the emergency contact (ICE name and phone). GET /patientnotes/{PatNum}.
Eingabe-Schema
{
"type": "object",
"properties": {
"patient_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "PatNum."
}
},
"required": [
"patient_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_appointments(patient_id, status, operatory, date, date_start, ...)
List appointments, filtered by patient, status, operatory, a day or a date range, clinic, appointment type, or changed since. Each has AptNum, PatNum, status, AptDateTime, pattern, provider, operatory, note and procedures. Use `date` for one day (e.g. today's schedule) or date_start/date_end for a range. GET /appointments.
Eingabe-Schema
{
"type": "object",
"properties": {
"patient_id": {
"description": "PatNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"status": {
"type": "string",
"enum": [
"Scheduled",
"Complete",
"UnschedList",
"ASAP",
"Broken",
"Planned",
"PtNote",
"PtNoteCompleted"
]
},
"operatory": {
"description": "OperatoryNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date": {
"description": "One day.",
"type": "string"
},
"date_start": {
"description": "Range start, inclusive.",
"type": "string"
},
"date_end": {
"description": "Range end, inclusive.",
"type": "string"
},
"clinic": {
"description": "ClinicNum; 0 = appointments not attached to a clinic.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"appointment_type": {
"description": "AppointmentTypeNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_get_appointment(appointment_id)
One appointment by AptNum, with its patient, time, provider, operatory, status, confirmation, note and procedures. GET /appointments/{AptNum}.
Eingabe-Schema
{
"type": "object",
"properties": {
"appointment_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "AptNum."
}
},
"required": [
"appointment_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_asap_appointments(clinic, provider, limit, offset)
The ASAP list: appointments whose priority is ASAP (patients who want an earlier time). ClinicNum is required when the office uses clinics (use 0 for no clinic). GET /appointments/ASAP.
Eingabe-Schema
{
"type": "object",
"properties": {
"clinic": {
"description": "ClinicNum; 0 = not attached to a clinic. Required if clinics are enabled.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"provider": {
"description": "ProvNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_find_open_slots(date, date_start, date_end, length_minutes, provider, ...)
Open schedule slots for a provider and operatory (like the Appointments module search): each has DateTimeStart, DateTimeEnd, ProvNum and OpNum. Dates must be today or later; the default is the next 14 days. GET /appointments/Slots.
Eingabe-Schema
{
"type": "object",
"properties": {
"date": {
"description": "One day (today or later).",
"type": "string"
},
"date_start": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"date_end": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"length_minutes": {
"description": "Skip slots shorter than this many minutes.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1440
},
"provider": {
"description": "ProvNum (default: the practice default provider).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"operatory": {
"description": "OperatoryNum the provider is assigned to.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_providers(clinic, changed_since, limit, offset)
Providers (dentists, hygienists, billing entities) with ProvNum, abbreviation, name, specialty, status and hidden flags. SSN/TIN is removed. Optionally only providers usable at one clinic, or only those changed since a time (not both). GET /providers.
Eingabe-Schema
{
"type": "object",
"properties": {
"clinic": {
"description": "ClinicNum: non-hidden providers not restricted to another clinic.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_operatories(clinic, limit, offset)
Operatories (treatment rooms) with OperatoryNum, name, abbreviation, assigned dentist and hygienist, clinic and hidden flag. GET /operatories.
Eingabe-Schema
{
"type": "object",
"properties": {
"clinic": {
"description": "ClinicNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_clinics(limit, offset)
All non-hidden clinics (locations) with address, billing address and phone. An empty list means the office does not use the Clinics feature. GET /clinics.
Eingabe-Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_appointment_types(limit, offset)
Appointment types (AppointmentTypeNum, name, default pattern, required procedure codes, hidden flag). GET /appointmenttypes.
Eingabe-Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_procedure_codes(changed_since, limit, offset)
The office's procedure codes (CodeNum, ADA code, description, category, treatment area, hygiene flag). Use CodeNum to filter procedure logs. Page with limit/offset. GET /procedurecodes.
Eingabe-Schema
{
"type": "object",
"properties": {
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_procedure_logs(patient_id, appointment_id, procedure_date, status, clinic, ...)
Procedure log entries (treatment-planned, complete, existing, referred, deleted) filtered by patient, appointment, date, status, clinic, procedure code or creation time. Each has ProcNum, PatNum, ProcDate, fee, tooth, surface, status, provider and code. Page with limit/offset. GET /procedurelogs.
Eingabe-Schema
{
"type": "object",
"properties": {
"patient_id": {
"description": "PatNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"appointment_id": {
"description": "AptNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"procedure_date": {
"type": "string",
"description": "A date, yyyy-MM-dd."
},
"status": {
"description": "TP treatment plan, C complete, EC/EO existing, R referred out, D deleted, Cn condition, TPi inactive TP.",
"type": "string",
"enum": [
"TP",
"C",
"EC",
"EO",
"R",
"D",
"Cn",
"TPi"
]
},
"clinic": {
"description": "ClinicNum.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"code_num": {
"description": "CodeNum from opendental_list_procedure_codes.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"created_since": {
"description": "Procedures created on or after this time.",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_commlogs(patient_id, changed_since, limit, offset)
Communication log entries (calls, texts, emails, letters) for a patient or changed since a time: CommlogNum, PatNum, date, mode, sent or received, note. Page with limit/offset. GET /commlogs.
Eingabe-Schema
{
"type": "object",
"properties": {
"patient_id": {
"description": "PatNum.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"changed_since": {
"description": "Only items changed after this time, yyyy-MM-dd HH:mm:ss (DateTStamp).",
"type": "string"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢opendental_list_recalls_due(date_start, date_end, provider, clinic, recall_type, ...)
The Recall List as in Open Dental's Appointment module: patients due for recall (prophy, perio) with due date, interval, reminders sent, last reminder, preferred contact and status. Defaults follow the office's recall preferences. Page with limit/offset. GET /recalls/List.
Eingabe-Schema
{
"type": "object",
"properties": {
"date_start": {
"description": "Due date range start.",
"type": "string"
},
"date_end": {
"description": "Due date range end.",
"type": "string"
},
"provider": {
"description": "ProvNum (primary or secondary provider).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"clinic": {
"description": "ClinicNum; 0 = unassigned.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"recall_type": {
"description": "Typically \"Prophy\" or \"Perio\".",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"include_reminded": {
"description": "Include patients who already received a reminder (default false).",
"type": "boolean"
},
"limit": {
"description": "Results per request, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Items to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 10000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis