MCP server
ByDoctor MCP by usefulapi
Read appointments, professionals and rooms; book, update and cancel visits in ByDoctor.
- Runs
- Remotely
- Version
- 1.3.0
- Listing updated
- 4 days ago
About ByDoctor MCP by usefulapi
ByDoctor MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http bydoctor https://bydoctor.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://bydoctor.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bydoctor": {
"url": "https://bydoctor.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"bydoctor": {
"type": "http",
"url": "https://bydoctor.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bydoctor": {
"serverUrl": "https://bydoctor.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bydoctor": {
"type": "http",
"url": "https://bydoctor.usefulapi.io/mcp"
}
}
}Tools this server provides (15)
Read directly from the server.
- 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 appointments:write. PATCH /appointments/{id}.
- 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}.
ByDoctor MCP by usefulapi FAQ
How do I add ByDoctor MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http bydoctor https://bydoctor.usefulapi.io/mcp