ERClinic MCP by usefulapi
Find agenda times, read appointments; book, confirm and cancel them in ERClinic.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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-httpWhat it can do
Tool inventory
Tools (15)
π’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
Evidence