# SmartDoctor MCP by usefulapi

> SmartDoctor MCP by usefulapi is an MCP server. Find open slots, book, move and cancel consultations, and read prices in SmartDoctor. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/smartdoctor/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/smartdoctor
- **MCP Registry name:** io.usefulapi/smartdoctor
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http smartdoctor https://smartdoctor.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://smartdoctor.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "smartdoctor": {
      "url": "https://smartdoctor.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "smartdoctor": {
      "type": "http",
      "url": "https://smartdoctor.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/smartdoctor-mcp-by-usefulapi
