ERClinic MCP by usefulapi

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

Should I use this

Quality & Safety

A
Description quality
97%
Schema completeness
91%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,184Tokens (tool definitions)
~1.6 KBTypical response size
Significant attention impact (2.49% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

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

Remote endpoints

https://erclinic.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (15)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒erclinic_list_unities

List the clinic's units, and whether each accepts in-person and tele-consultation bookings. Good first call. GET /agenda/unities.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_list_specialties(professional_id)

List active specialties (numeric ids), optionally only those of one professional. GET /agenda/specialties.

Input Schema

{
  "type": "object",
  "properties": {
    "professional_id": {
      "description": "Professional id (slug) from erclinic_list_professionals.",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_list_professionals(insurance_id, procedure_id, specialty_id)

List the clinic's professionals (id, name, gender, age range), optionally filtered by insurance, procedure or specialty. GET /agenda/professionals.

Input Schema

{
  "type": "object",
  "properties": {
    "insurance_id": {
      "description": "Insurance id (slug). Needs professional_id in the API; use only with the other filters.",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "procedure_id": {
      "description": "Procedure id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "specialty_id": {
      "description": "Specialty id (numeric).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_list_procedures(professional_id, insurance_id, specialty_id)

List active procedures for one professional (id, name, preparation text). Insurance or specialty filters also need professional_id. GET /agenda/procedures.

Input Schema

{
  "type": "object",
  "properties": {
    "professional_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Professional id (slug). Required."
    },
    "insurance_id": {
      "description": "Insurance id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "specialty_id": {
      "description": "Specialty id (numeric).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    }
  },
  "required": [
    "professional_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_list_insurance(professional_id)

List active insurance plans (convΓͺnios) with their ids, optionally for one professional. GET /agenda/insurance.

Input Schema

{
  "type": "object",
  "properties": {
    "professional_id": {
      "description": "Professional id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_get_available_dates(date_min, date_max, insurance_id, procedure_id, professional_id, ...)

List dates with free agenda slots. Defaults: from today to 30 days ahead. Insurance or specialty filters need professional_id. GET /agenda/available-dates.

Input Schema

{
  "type": "object",
  "properties": {
    "date_min": {
      "description": "First date, yyyy-mm-dd (default today).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_max": {
      "description": "Last date, yyyy-mm-dd (default today + 30 days).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "insurance_id": {
      "description": "Insurance id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "procedure_id": {
      "description": "Procedure id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "professional_id": {
      "description": "Professional id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "specialty_id": {
      "description": "Specialty id (numeric).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_get_available_times(date, insurance_id, procedure_id, professional_id, specialty_id)

List the free times on one date. Insurance or specialty filters need professional_id. GET /agenda/available-times.

Input Schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "The date to check, yyyy-mm-dd."
    },
    "insurance_id": {
      "description": "Insurance id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "procedure_id": {
      "description": "Procedure id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "professional_id": {
      "description": "Professional id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "specialty_id": {
      "description": "Specialty id (numeric).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    }
  },
  "required": [
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_list_appointments(date_min, date_max, id, patient_id, professional_id, ...)

List appointments by date range, appointment id, patient, professional or status (AGENDADO, CANCELADO, CONFIRMADO, ATENDIDO). GET /agenda/appointments/list.

Input Schema

{
  "type": "object",
  "properties": {
    "date_min": {
      "description": "From this date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_max": {
      "description": "Up to this date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "id": {
      "description": "One appointment id.",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "patient_id": {
      "description": "Only this patient's appointments.",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "professional_id": {
      "description": "Only this professional's appointments (sent as profissional_id).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "status": {
      "description": "AGENDADO, CANCELADO, CONFIRMADO or ATENDIDO.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_find_patient(id, cpf, phone)

Find one patient by id, CPF or phone. Returns personal data (sensitive, LGPD). GET /patients.

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Patient id (slug).",
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$"
    },
    "cpf": {
      "description": "Patient CPF (Brazilian tax id), digits.",
      "type": "string"
    },
    "phone": {
      "description": "Patient phone.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟒erclinic_list_birthdays(birthday)

List patients whose birthday is on one month and day (mm-dd). Returns personal data (sensitive, LGPD). GET /patients/birthday.

Input Schema

{
  "type": "object",
  "properties": {
    "birthday": {
      "type": "string",
      "pattern": "^\\d{2}-\\d{2}$",
      "description": "Month and day, mm-dd."
    }
  },
  "required": [
    "birthday"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
πŸ”΄erclinic_create_appointment(date, time, insurance_id, professional_id, patient_id, ...)

Book a new appointment in the clinic agenda. Creates a real booking that patients and staff see. POST /agenda/appointments/.

Input Schema

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Appointment date, yyyy-mm-dd."
    },
    "time": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
      "description": "Appointment time, HH:MM."
    },
    "insurance_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Insurance id (slug). Required."
    },
    "professional_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Professional id (slug). Required (sent as profissional_id)."
    },
    "patient_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Patient id (slug). Required."
    },
    "patient_name": {
      "type": "string",
      "description": "Patient full name. Required."
    },
    "patient_cpf": {
      "type": "string",
      "description": "Patient CPF. Required."
    },
    "patient_cell_phone": {
      "type": "string",
      "description": "Patient mobile phone. Required."
    },
    "procedure_id": {
      "description": "Procedure id (slug).",
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[-a-zA-Z0-9_]+$"
        },
        {
          "type": "null"
        }
      ]
    },
    "modality": {
      "type": "string",
      "enum": [
        "PRESENCIAL",
        "TELECONSULTA"
      ],
      "description": "PRESENCIAL (in person) or TELECONSULTA (tele-consultation)."
    }
  },
  "required": [
    "date",
    "time",
    "insurance_id",
    "professional_id",
    "patient_id",
    "patient_name",
    "patient_cpf",
    "patient_cell_phone"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟑erclinic_confirm_appointment(agenda_id)

Set one appointment's status to CONFIRMADO. Repeating the call leaves it confirmed. POST /agenda/appointments/{agenda_id}/confirm.

Input Schema

{
  "type": "object",
  "properties": {
    "agenda_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Appointment id from erclinic_list_appointments."
    }
  },
  "required": [
    "agenda_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
πŸ”΄erclinic_cancel_appointment(agenda_id)

Set one appointment's status to CANCELADO. The slot is freed for other bookings. POST /agenda/appointments/{agenda_id}/cancel.

Input Schema

{
  "type": "object",
  "properties": {
    "agenda_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Appointment id from erclinic_list_appointments."
    }
  },
  "required": [
    "agenda_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
πŸ”΄erclinic_create_patient(name, cpf, phone, birthdate, gender, ...)

Register a new patient record in the clinic. Creates personal data (sensitive, LGPD). POST /patients.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full name. Required."
    },
    "cpf": {
      "type": "string",
      "description": "CPF. Required."
    },
    "phone": {
      "type": "string",
      "description": "Phone. Required."
    },
    "birthdate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Birth date, yyyy-mm-dd. Required."
    },
    "gender": {
      "type": "string",
      "enum": [
        "M",
        "F"
      ],
      "description": "M or F."
    },
    "email": {
      "description": "Email.",
      "anyOf": [
        {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "observation": {
      "description": "Free-text note.",
      "type": [
        "string",
        "null"
      ]
    },
    "address": {
      "description": "Street address.",
      "type": [
        "string",
        "null"
      ]
    },
    "city": {
      "description": "City.",
      "type": [
        "string",
        "null"
      ]
    },
    "uf": {
      "description": "State code, two letters.",
      "type": [
        "string",
        "null"
      ]
    },
    "cep": {
      "description": "Postal code (CEP).",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "name",
    "cpf",
    "phone",
    "birthdate",
    "gender"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
πŸ”΄erclinic_update_patient(patient_id, name, cpf, phone, birthdate, ...)

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

Input Schema

{
  "type": "object",
  "properties": {
    "patient_id": {
      "type": "string",
      "pattern": "^[-a-zA-Z0-9_]+$",
      "description": "Patient id (slug). Sent in the path and as the id query value."
    },
    "name": {
      "type": "string",
      "description": "Full name."
    },
    "cpf": {
      "type": "string",
      "description": "CPF."
    },
    "phone": {
      "type": "string",
      "description": "Phone."
    },
    "birthdate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Birth date, yyyy-mm-dd."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email (send the current value if unchanged)."
    },
    "gender": {
      "type": "string",
      "enum": [
        "M",
        "F"
      ],
      "description": "M or F."
    },
    "address": {
      "type": "string",
      "description": "Street address (send the current value if unchanged)."
    },
    "city": {
      "type": "string",
      "description": "City (send the current value if unchanged)."
    },
    "uf": {
      "type": "string",
      "description": "State code (send the current value if unchanged)."
    },
    "cep": {
      "type": "string",
      "description": "Postal code (send the current value if unchanged)."
    },
    "observation": {
      "type": "string",
      "description": "Free-text note (send the current value if unchanged)."
    }
  },
  "required": [
    "patient_id",
    "name",
    "cpf",
    "phone",
    "birthdate",
    "email",
    "gender",
    "address",
    "city",
    "uf",
    "cep",
    "observation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded15 tools