ByDoctor MCP by usefulapi
io.usefulapi/bydoctor · v1.4.0 · MCP 2025-11-25
Read appointments, professionals and rooms; book, update and cancel visits in ByDoctor.
Reachability
reachable
checked 2026-11-21 05:39 UTC
Registry status active
Tools pinned 15
6f6589e80fd9
Tools last changed
2026-11-21
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Website
https://usefulapi.io/bydoctor/
Remote endpoints
https://bydoctor.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:39 | tools changed | 0 added, 0 removed, 2 changed |
| 2026-11-12 05:30 | first capture | 15 tools pinned |
Pinned tool definitions (15)
| Tool | Description |
|---|---|
| bydoctor_list_appointments | List clinic appointments, oldest update first, with filters for date range, status, modality, professional, patient and room. Use updated_since to sync only what changed. Returns results[] plus next/previous cursor URLs. GET /appointments. |
| bydoctor_get_appointment | Get one appointment by its UUID id, with patient, professional, room, type, status and times. GET /appointments/{id}. |
| bydoctor_list_patients | Find clinic patients by exact CPF or phone, or by partial name. CPF, e-mail, birth date and gender are never returned. Use this before creating an appointment to avoid duplicate patients. GET /patients. |
| bydoctor_get_patient | Get one patient by id: name, phone, active flag and timestamps. GET /patients/{id}. |
| bydoctor_list_professionals | List the active professionals who see patients: id, name and main specialty. Use the id as professional_id. GET /professionals. |
| bydoctor_get_professional | Get one active professional by id: name and specialty. GET /professionals/{id}. |
| bydoctor_list_rooms | List the active clinic rooms: id and name. Empty when the clinic does not use rooms. Use the id as room_id. GET /rooms. |
| bydoctor_get_room | Get one active room by id: name. GET /rooms/{id}. |
| bydoctor_list_appointment_types | List the active appointment types, such as consultation or follow-up: id and name. Use the id as appointment_type_id. GET /appointment-types. |
| bydoctor_get_appointment_type | Get one active appointment type by id: name. GET /appointment-types/{id}. |
| bydoctor_create_appointment | WRITE: books a new in-person appointment with status scheduled, for an existing patient, professional and appointment type. Teleconsults are not created by the API. Needs the appointments:write scope. POST /appointments. |
| bydoctor_update_appointment | WRITE: changes only the fields you send: start_at, professional_id, room_id, note, or status (scheduled or confirmed only). A confirmed appointment accepts only a status change; move it back to scheduled first to reschedule. Needs... |
| bydoctor_cancel_appointment | WRITE: cancels an in-person appointment that is scheduled (move a confirmed one back to scheduled first). Repeating the cancel returns the same result. Needs appointments:write. POST /appointments/{id}/cancel. |
| bydoctor_create_patient | WRITE: creates a patient record and returns its id for bydoctor_create_appointment. Search by CPF or phone first to avoid duplicates; a CPF already used by another patient in the clinic is refused (409). Needs patients:write. POST /patients. |
| bydoctor_update_patient | WRITE: changes only the fields you send. Send null to clear phone, email, cpf or birth_date; name and gender cannot be cleared. A CPF used by another patient is refused (409). Needs patients:write. PATCH /patients/{id}. |
Get alerted when this changes.
Email the moment io.usefulapi/bydoctor drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/bydoctor)
Maintain this server? Add the badge to your README. It links your users to this live status page.