# ERClinic MCP by usefulapi

> ERClinic MCP by usefulapi is an MCP server. Find agenda times, read appointments; book, confirm and cancel them in ERClinic. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Find agenda times, read appointments; book, confirm and cancel them in ERClinic.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `erclinic_list_unities`: List the clinic's units, and whether each accepts in-person and tele-consultation bookings. Good first call. GET /agenda/unities.
- `erclinic_list_specialties`: List active specialties (numeric ids), optionally only those of one professional. GET /agenda/specialties.
- `erclinic_list_professionals`: List the clinic's professionals (id, name, gender, age range), optionally filtered by insurance, procedure or specialty. GET /agenda/professionals.
- `erclinic_list_procedures`: List active procedures for one professional (id, name, preparation text). Insurance or specialty filters also need professional_id. GET /agenda/procedures.
- `erclinic_list_insurance`: List active insurance plans (convênios) with their ids, optionally for one professional. GET /agenda/insurance.
- `erclinic_get_available_dates`: List dates with free agenda slots. Defaults: from today to 30 days ahead. Insurance or specialty filters need professional_id. GET /agenda/available-dates.
- `erclinic_get_available_times`: List the free times on one date. Insurance or specialty filters need professional_id. GET /agenda/available-times.
- `erclinic_list_appointments`: List appointments by date range, appointment id, patient, professional or status (AGENDADO, CANCELADO, CONFIRMADO, ATENDIDO). GET /agenda/appointments/list.
- `erclinic_find_patient`: Find one patient by id, CPF or phone. Returns personal data (sensitive, LGPD). GET /patients.
- `erclinic_list_birthdays`: List patients whose birthday is on one month and day (mm-dd). Returns personal data (sensitive, LGPD). GET /patients/birthday.
- `erclinic_create_appointment`: Book a new appointment in the clinic agenda. Creates a real booking that patients and staff see. POST /agenda/appointments/.
- `erclinic_confirm_appointment`: Set one appointment's status to CONFIRMADO. Repeating the call leaves it confirmed. POST /agenda/appointments/{agenda_id}/confirm.
- `erclinic_cancel_appointment`: Set one appointment's status to CANCELADO. The slot is freed for other bookings. POST /agenda/appointments/{agenda_id}/cancel.
- `erclinic_create_patient`: Register a new patient record in the clinic. Creates personal data (sensitive, LGPD). POST /patients.
- `erclinic_update_patient`: Update a patient's record. The API requires every field, so send the current value for any field you do not change. Personal data (sensitive, LGPD). PUT /patients/{patient_id}.

## FAQ

### How do I add ERClinic MCP by usefulapi to Claude Code?

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

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