MCP server for Dentally — dental practice management, safely exposed to AI assistants
Strong foundation with clear naming, comprehensive descriptions, and well-structured schemas. All 7 tools follow verb_noun convention (list_, get_, find_, book_, reschedule_, cancel_). Descriptions are detailed (100-250 chars) and include prerequisites and warnings. Input schemas are complete with types and descriptions for all parameters. However, output schemas are not documented, LLMs cannot predict response structure. Error handling lacks recovery guidance. Tool annotations (destructiveHint, idempotentHint) are declared but not visible in source. No pagination documented for list_appointments despite API guidance about 3-month caps.
Book an appointment. Requires confirmation. Take `start_time` from `find_appointment_slots`, not from a gap you inferred in a diary listing — a listing does not show blocks, leave, or surgery closures.
Cancel an appointment. Requires confirmation. This sets the appointment's state to cancelled rather than deleting it, so the practice keeps its cancellation and failed-to-attend reporting.
Find free appointment slots — what you can actually offer a patient. Always call this before booking. Booking a time taken from a diary listing rather than from availability is how you double-book a surgery.
Get one appointment: time, duration, state, patient and practitioner.
List the practice's appointment reasons and their default durations.
Output schemas not documented. LLMs cannot predict response structure for any tool. Downstream tool chaining requires guessing field names.
Error handling lacks recovery guidance. No indication of which errors are retryable, user-fixable, or fatal. No suggestions for next steps on failure.
Pagination not explicitly documented for list_appointments despite API guidance that queries >3 months timeout. No limit parameter default or max stated.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 69 | <=2025-11-25 | v2 |
List appointments in a date range — the practice diary. With no dates this returns today. The range is capped at about three months because Dentally's own guidance is that wider filters on this endpoint time out.
Move an existing appointment to a new time. Requires confirmation.
Tool annotations (destructiveHint, idempotentHint, readOnlyHint) declared in FEATURES but not visible in source code registration. Verify FastMCP integration.
Confirmation/dry-run pattern not visible for irreversible operations (book, reschedule, cancel). Agents cannot preview consequences before committing.