Skip to content
MCP server

SmartDoctor MCP by usefulapi

Find open slots, book, move and cancel consultations, and read prices in SmartDoctor.

Install
Runs
Remotely
Version
1.3.0
Listing updated
5 days ago

About SmartDoctor MCP by usefulapi

SmartDoctor 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 smartdoctor https://smartdoctor.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://smartdoctor.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "smartdoctor": {
      "url": "https://smartdoctor.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": {
    "smartdoctor": {
      "type": "http",
      "url": "https://smartdoctor.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "smartdoctor": {
      "serverUrl": "https://smartdoctor.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "smartdoctor": {
      "type": "http",
      "url": "https://smartdoctor.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (9)

Read directly from the server.

smartdoctor_list_appointments
List the clinic's appointments from a start date (default today), optionally for one patient or one status. Uses GET /integracao/agendas/listar.
smartdoctor_get_appointment
Get one appointment by id: date, time, status, specialty, doctor, unit, price and patient. Uses GET /integracao/agendas/{id}.
smartdoctor_check_appointment_conflict
Check whether the patient already has an appointment on that date for that specialty, to avoid a double booking. An empty list means no conflict. Uses GET /integracao/agendas/verificar.
smartdoctor_list_free_slots
List the free time slots per doctor for one specialty, before a time is offered to a patient. Read-only, sent as a POST. Uses POST /integracao/controle-agendas/horarios-disponiveis.
smartdoctor_find_patient_by_cpf
Check whether a CPF is already a patient of the clinic, and get the contact details. The answer has encontrado (true or false); when false, the patient is not registered. Uses GET /integracao/pacientes/cpf.
smartdoctor_list_prices
List the clinic's active specialties and their prices (convenio PARTICULAR and others). Uses GET /integracao/consultas-valor.
smartdoctor_create_appointment
Book a consultation for a patient. Without a time, the first free time of the day is used. For a new patient (CPF not yet registered), patient_name, patient_phone and patient_birth_date are all required. The specialty needs a PARTICULAR price and a schedule on that date. Uses POST /integracao/agendas.
smartdoctor_reschedule_appointment
Move an existing appointment to a new date and time. The new time must be free. Uses PUT /integracao/agendas with the appointment id.
smartdoctor_cancel_appointment
Cancel an appointment by id (status becomes CANCELADO). The appointment is kept in the clinic's records. Uses PUT /integracao/agendas.

SmartDoctor MCP by usefulapi FAQ

How do I add SmartDoctor MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http smartdoctor https://smartdoctor.usefulapi.io/mcp