Skip to content
MCP server

ERClinic MCP by usefulapi

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

Install
Runs
Remotely
Version
1.3.0
Listing updated
4 days ago

About ERClinic MCP by usefulapi

ERClinic 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 erclinic https://erclinic.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

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

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

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

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

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

Tools this server provides (15)

Read directly from the server.

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

ERClinic MCP by usefulapi 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