Feegow MCP by usefulapi is an MCP server published by io.usefulapi, hosted at feegow.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 26 tools, including feegow_list_units, feegow_list_locations, feegow_list_specialties, feegow_list_professionals, feegow_get_professional.
Read clinic appointments, patients and finances; manage bookings and patient registration.
4,163 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The clinic's main unit (matriz, unidade_id 0) and its branches, with trade name, CNPJ, address and contacts. Use the unit ids to filter other tools. GET /company/list-unity.
No parameters.
{
"name": "feegow_list_units",
"title": "List units (branches)",
"description": "The clinic's main unit (matriz, unidade_id 0) and its branches, with trade name, CNPJ, address and contacts. Use the unit ids to filter other tools. GET /company/list-unity.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List units",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Rooms/locations registered in each unit (id, name, unidade_id). The location id is needed to create appointments. GET /company/list-local.
No parameters.
{
"name": "feegow_list_locations",
"title": "List locations (rooms)",
"description": "Rooms/locations registered in each unit (id, name, unidade_id). The location id is needed to create appointments. GET /company/list-local.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Medical specialties offered, with their default consultation procedure ids and whether they show in online booking. GET /specialties/list.
| Parameter | Type | Description |
|---|---|---|
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
{
"name": "feegow_list_specialties",
"title": "List specialties",
"description": "Medical specialties offered, with their default consultation procedure ids and whether they show in online booking. GET /specialties/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
}
}
},
"annotations": {
"title": "List specialties",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Doctors and other professionals (names and ids), active or inactive, optionally by unit or specialty. GET /professional/list.
| Parameter | Type | Description |
|---|---|---|
| active | boolean | true (default) = active professionals, false = inactive. |
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
| specialty_id | integer | Only professionals of this specialty (see feegow_list_specialties). |
{
"name": "feegow_list_professionals",
"title": "List professionals",
"description": "Doctors and other professionals (names and ids), active or inactive, optionally by unit or specialty. GET /professional/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"active": {
"type": "boolean",
"description": "true (default) = active professionals, false = inactive."
},
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
},
"specialty_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only professionals of this specialty (see feegow_list_specialties).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List professionals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One professional's details and specialties. GET /professional/search.
| Parameter | Type | Description |
|---|---|---|
| professional_id * | integer | Feegow professional id (see feegow_list_professionals). |
{
"name": "feegow_get_professional",
"title": "Get professional",
"description": "One professional's details and specialties. GET /professional/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"professional_id"
],
"properties": {
"professional_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Feegow professional id (see feegow_list_professionals).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get professional",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Health insurances (convênios) accepted by one professional. GET /professional/insurance.
| Parameter | Type | Description |
|---|---|---|
| professional_id * | integer | Feegow professional id. |
{
"name": "feegow_list_professional_insurances",
"title": "List insurances a professional accepts",
"description": "Health insurances (convênios) accepted by one professional. GET /professional/insurance.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"professional_id"
],
"properties": {
"professional_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Feegow professional id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List professional insurances",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}All accepted health insurances with their plans. GET /insurance/list.
| Parameter | Type | Description |
|---|---|---|
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
{
"name": "feegow_list_insurances",
"title": "List insurances (convênios)",
"description": "All accepted health insurances with their plans. GET /insurance/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
}
}
},
"annotations": {
"title": "List insurances",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Procedure types (consultation, exam, surgery, return...) and their ids, used by feegow_list_procedures. GET /procedures/types.
No parameters.
{
"name": "feegow_list_procedure_types",
"title": "List procedure types",
"description": "Procedure types (consultation, exam, surgery, return...) and their ids, used by feegow_list_procedures. GET /procedures/types.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List procedure types",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Procedures (consultations, exams...) with price IN CENTS (R$ 12.00 = 1200), duration and online-booking flag. Give a procedure type (see feegow_list_procedure_types) or one procedure id; optionally narrow by name, unit, specialty, professional, patient or price table. GET /procedures/list.
| Parameter | Type | Description |
|---|---|---|
| name | string | Part of the procedure name. |
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
| patient_id | integer | Prices for this patient (their price table / insurance). |
| procedure_id | integer | One procedure id (use when no type is given). |
| specialty_id | integer | |
| price_table_id | integer | Private price table id. |
| professional_id | integer | |
| procedure_type_id | integer | Procedure type id (feegow_list_procedure_types). |
Appointment status ids and names (booked, confirmed, in service, attended, no-show, cancelled...), used to filter and update appointments. GET /appoints/status.
No parameters.
{
"name": "feegow_list_appointment_statuses",
"title": "List appointment statuses",
"description": "Appointment status ids and names (booked, confirmed, in service, attended, no-show, cancelled...), used to filter and update appointments. GET /appoints/status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List appointment statuses",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Reasons (motivos) that cancel or reschedule an appointment can carry; the id is required by feegow_cancel_appointment and feegow_reschedule_appointment. GET /appoints/motives.
No parameters.
{
"name": "feegow_list_appointment_reasons",
"title": "List cancel/reschedule reasons",
"description": "Reasons (motivos) that cancel or reschedule an appointment can carry; the id is required by feegow_cancel_appointment and feegow_reschedule_appointment. GET /appoints/motives.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List cancel and reschedule reasons",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Channels an appointment can be booked through (online booking, clinic...). GET /appoints/list-channel.
No parameters.
{
"name": "feegow_list_booking_channels",
"title": "List booking channels",
"description": "Channels an appointment can be booked through (online booking, clinic...). GET /appoints/list-channel.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List booking channels",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Patient acquisition sources (origens) and their ids, used when creating a patient. GET /patient/list-sources.
No parameters.
{
"name": "feegow_list_patient_sources",
"title": "List patient sources",
"description": "Patient acquisition sources (origens) and their ids, used when creating a patient. GET /patient/list-sources.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List patient sources",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Appointments in a date range (or one appointment by id), filtered by professional, patient, unit, location, specialty, channel, procedure or status. Paged: pass the previous reply's next_start. Health data: contains patient ids. GET /appoints/search.
| Parameter | Type | Description |
|---|---|---|
| start | integer | Position of the first row (default 0). Use next_start from the previous reply. |
| date_to | string | Last day, yyyy-mm-dd. Required unless appointment_id is given. |
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
| date_from | string | First day, yyyy-mm-dd. Required unless appointment_id is given. |
| is_return | boolean | true = only return visits (retorno). |
| page_size | integer | Rows per page, 1-200 (default 50). |
| channel_id | integer | Booking channel id (feegow_list_booking_channels). |
| patient_id | integer | |
| status_ids | array | Only these statuses (feegow_list_appointment_statuses), e.g. [1, 7] for booked. |
Free appointment times for a specialty or a procedure between two dates, optionally for one professional, unit or insurance. Use before feegow_create_appointment. GET /appoints/available-schedule.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | What to search by: a specialty or a procedure. |
| age_to | integer | Patient's maximum age. |
| date_to * | string | A date, yyyy-mm-dd. |
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
| age_from | integer | Patient's minimum age. |
| date_from * | string | A date, yyyy-mm-dd. |
| insurance_id | integer | Insurance (convênio) id; see feegow_list_insurances. |
| procedure_id | integer | Required when kind is procedure. |
| specialty_id | integer | Required when kind is specialty. |
| professional_id |
Registered patients, filtered by phone, CPF, source, birthday (dd-mm) or last-changed date. Health data (LGPD): returns names, contacts and CPF. Paged: pass the previous reply's next_offset. GET /patient/list.
| Parameter | Type | Description |
|---|---|---|
| cpf | string | CPF, digits only. |
| limit | integer | Rows per page, 1-200 (default 50). |
| phone | string | Phone, digits only. |
| offset | integer | Rows to skip (default 0). |
| birthday | string | Birthday day and month, dd-mm (e.g. 30-01). |
| source_id | integer | Patient source id (feegow_list_patient_sources). |
| changed_since | string | Only patients changed on this date, yyyy-mm-dd. |
| include_health_program | boolean | true = include each patient's health program. |
{
"name": "feegow_list_patients",
"title": "List patients",
"description": "Registered patients, filtered by phone, CPF, source, birthday (dd-mm) or last-changed date. Health data (LGPD): returns names, contacts and CPF. Paged: pass the previous reply's next_offset. GET /patient/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cpf": {
"type": "string",
"pattern": "^\\d{1,11}$",
"description": "CPF, digits only."
},
"limit": {
"type": "integer",
"maximum": 200,
"description": "Rows per page, 1-200 (default 50).",
"exclusiveMinimum": 0
},
"phone": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Phone, digits only."
},
"offset": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0)."
},
"birthday": {
"type": "string",
"pattern": "^(0[1-9]|[12]\\d|3[01])-(0[1-9]|1[0-2])$",
"description": "Birthday day and month, dd-mm (e.g. 30-01)."
},
"source_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Patient source id (feegow_list_patient_sources).",
"exclusiveMinimum": 0
},
"changed_since": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Only patients changed on this date, yyyy-mm-dd."
},
"include_health_program": {
"type": "boolean",
"description": "true = include each patient's health program."
}
}
},
"annotations": {
"title": "List patients",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One patient by id or CPF: name, birth date, contacts, address, insurance. Health data (LGPD). Feegow caches reads for 5 minutes; set fresh=true right after an edit. GET /patient/search.
| Parameter | Type | Description |
|---|---|---|
| cpf | string | CPF, digits only (used when no patient_id). |
| fresh | boolean | true = bypass Feegow's 5-minute cache. |
| patient_id | integer | Feegow patient id. |
| include_photo_url | boolean | true = include the patient photo URL. |
| include_health_program | boolean |
{
"name": "feegow_get_patient",
"title": "Get patient",
"description": "One patient by id or CPF: name, birth date, contacts, address, insurance. Health data (LGPD). Feegow caches reads for 5 minutes; set fresh=true right after an edit. GET /patient/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cpf": {
"type": "string",
"pattern": "^\\d{1,11}$",
"description": "CPF, digits only (used when no patient_id)."
},
"fresh": {
"type": "boolean",
"description": "true = bypass Feegow's 5-minute cache."
},
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Feegow patient id.",
"exclusiveMinimum": 0
},
"include_photo_url": {
"type": "boolean",
"description": "true = include the patient photo URL."
},
"include_health_program": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Get patient",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Dependents registered under one patient. Health data (LGPD). GET /patient/list-dependents.
| Parameter | Type | Description |
|---|---|---|
| patient_id * | integer |
{
"name": "feegow_list_patient_dependents",
"title": "List patient dependents",
"description": "Dependents registered under one patient. Health data (LGPD). GET /patient/list-dependents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"patient_id"
],
"properties": {
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List patient dependents",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Treatment/procedure proposals with values in REAIS (R$): for one patient, and/or created (or last changed) in a date range. Give patient_id, or both dates. GET /proposal/list.
| Parameter | Type | Description |
|---|---|---|
| date_to | string | A date, yyyy-mm-dd. |
| date_from | string | A date, yyyy-mm-dd. |
| date_kind | string | Which date the range filters: created (default) or last changed. |
| patient_id | integer |
{
"name": "feegow_list_proposals",
"title": "List proposals (quotes)",
"description": "Treatment/procedure proposals with values in REAIS (R$): for one patient, and/or created (or last changed) in a date range. Give patient_id, or both dates. GET /proposal/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"date_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"date_kind": {
"enum": [
"created",
"changed"
],
"type": "string",
"description": "Which date the range filters: created (default) or last changed."
},
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List proposals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Financial invoices (contas) in a date range: receivables (C) or payables (D), with value, description, payer/payee, invoice number and payment details. Optionally one unit, invoice or appointment. Financial data. GET /financial/list-invoice.
| Parameter | Type | Description |
|---|---|---|
| date_to * | string | A date, yyyy-mm-dd. |
| unit_id | integer | Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units. |
| date_from * | string | A date, yyyy-mm-dd. |
| direction * | string | receivable = contas a receber (C), payable = contas a pagar (D). |
| invoice_id | integer | |
| appointment_id | integer |
{
"name": "feegow_list_invoices",
"title": "List invoices (receivables and payables)",
"description": "Financial invoices (contas) in a date range: receivables (C) or payables (D), with value, description, payer/payee, invoice number and payment details. Optionally one unit, invoice or appointment. Financial data. GET /financial/list-invoice.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"direction",
"date_from",
"date_to"
],
"properties": {
"date_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
},
"date_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"direction": {
"enum": [
"receivable",
"payable"
],
"type": "string",
"description": "receivable = contas a receber (C), payable = contas a pagar (D)."
},
"invoice_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: books a new appointment in the clinic's agenda (not in the past). Check feegow_get_available_schedule first; a taken slot or unknown patient is refused. Feegow may notify the patient (SMS/e-mail/WhatsApp) according to the clinic's own automation settings. valor is in CENTS and must be 0 with insurance. POST /appoints/new-appoint.
| Parameter | Type | Description |
|---|---|---|
| date * | string | Appointment day, yyyy-mm-dd (today or later). |
| time * | string | Time of day, 24 h, HH:MM or HH:MM:SS. |
| string | Patient e-mail. | |
| notes | string | Appointment note. |
| phone | string | Patient phone. |
| mobile | string | Patient mobile phone. |
| is_return | boolean | true = a return visit (retorno). |
| channel_id | integer | Booking channel id (feegow_list_booking_channels). |
| patient_id * | integer | |
| location_id * | integer |
WRITE: moves an existing appointment to a new date and time (the old slot is released). A reason id is required (feegow_list_appointment_reasons). Feegow may notify the patient according to the clinic's settings. POST /appoints/reschedule.
| Parameter | Type | Description |
|---|---|---|
| date * | string | New day, yyyy-mm-dd. |
| time * | string | New time, HH:MM or HH:MM:SS. |
| notes | string | Note on the change. |
| reason_id * | integer | Reason id from feegow_list_appointment_reasons. |
| appointment_id * | integer |
{
"name": "feegow_reschedule_appointment",
"title": "Reschedule appointment",
"description": "WRITE: moves an existing appointment to a new date and time (the old slot is released). A reason id is required (feegow_list_appointment_reasons). Feegow may notify the patient according to the clinic's settings. POST /appoints/reschedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appointment_id",
"reason_id",
"date",
"time"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "New day, yyyy-mm-dd."
},
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
"description": "New time, HH:MM or HH:MM:SS."
},
"notes": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Note on the change."
},
"reason_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reason id from feegow_list_appointment_reasons.",
"exclusiveMinimum": 0
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Reschedule appointment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: cancels an existing appointment (it cannot be restored through the API; book a new one instead). A reason id is required (feegow_list_appointment_reasons). Feegow may notify the patient according to the clinic's settings. POST /appoints/cancel-appoint.
| Parameter | Type | Description |
|---|---|---|
| notes | string | Note on the cancellation. |
| reason_id * | integer | Reason id from feegow_list_appointment_reasons. |
| appointment_id * | integer |
{
"name": "feegow_cancel_appointment",
"title": "Cancel appointment",
"description": "WRITE: cancels an existing appointment (it cannot be restored through the API; book a new one instead). A reason id is required (feegow_list_appointment_reasons). Feegow may notify the patient according to the clinic's settings. POST /appoints/cancel-appoint.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appointment_id",
"reason_id"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Note on the cancellation."
},
"reason_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reason id from feegow_list_appointment_reasons.",
"exclusiveMinimum": 0
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Cancel appointment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: sets an appointment's status (for example confirmed, waiting, attended, no-show) and adds a note to the agenda. Status ids: feegow_list_appointment_statuses. To cancel or move an appointment use the cancel/reschedule tools. POST /appoints/statusUpdate.
| Parameter | Type | Description |
|---|---|---|
| notes | string | Note added to the agenda entry. |
| status_id * | integer | |
| arrival_time | string | Arrival time shown in the waiting room (only for the waiting status), HH:MM. |
| appointment_id * | integer |
{
"name": "feegow_update_appointment_status",
"title": "Update appointment status",
"description": "WRITE: sets an appointment's status (for example confirmed, waiting, attended, no-show) and adds a note to the agenda. Status ids: feegow_list_appointment_statuses. To cancel or move an appointment use the cancel/reschedule tools. POST /appoints/statusUpdate.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"appointment_id",
"status_id"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Note added to the agenda entry."
},
"status_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"arrival_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
"description": "Arrival time shown in the waiting room (only for the waiting status), HH:MM."
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update appointment status",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: registers a new patient and returns the patient_id. Feegow does not duplicate: when a patient with the same CPF and birth date (or, without a CPF, the same name plus mobile, e-mail or birth date) exists, that patient's id is returned and nothing is created. Set no_cpf=true for a patient without CPF. Health data (LGPD): only register data the patient gave the clinic. POST /patient/create.
| Parameter | Type | Description |
|---|---|---|
| cpf | string | CPF, 11 digits, numbers only. |
| zip | string | CEP (max 9 characters). |
| city | string | City. |
| string | E-mail. | |
| notes | string | Note on the patient record. |
| phone | string | Phone, digits only. |
| state | string | State, two letters (e.g. RJ). |
| email2 | string | Second e-mail. |
| gender | string | M or F. |
| mobile | string | Mobile phone, digits only. |
| no_cpf | boolean |
WRITE: changes a patient's registration data. Only the fields you pass are sent; they overwrite stored values. CPF can only be set when absent, never replaced after registration (vendor rejects a different existing CPF). Health data (LGPD). Feegow caches reads for 5 minutes (use fresh=true in feegow_get_patient to see the change). POST /patient/edit.
| Parameter | Type | Description |
|---|---|---|
| cpf | string | CPF, 11 digits, numbers only. |
| zip | string | CEP (max 9 characters). |
| city | string | City. |
| string | E-mail. | |
| phone | string | Phone, digits only. |
| state | string | State, two letters (e.g. RJ). |
| gender | string | M or F. |
| mobile | string | Mobile phone, digits only. |
| number | string | Street number. |
| phone2 | string | Second phone, digits only. |
| address |
Tools for Feegow, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which appointments does Dr. Silva have tomorrow, and which are not yet confirmed?"; "Find the next free slots for a dermatology consultation this week."; "Book patient 6563 with professional 10 on 2026-11-03 at 15:00.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Feegow data. Free plan: 50 tool calls per month. Run feegow_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run feegow_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run feegow_upgrade without a plan: it returns both plans, each with a payment link for the user to open. feegow_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "feegow_list_procedures",
"title": "List procedures",
"description": "Procedures (consultations, exams...) with price IN CENTS (R$ 12.00 = 1200), duration and online-booking flag. Give a procedure type (see feegow_list_procedure_types) or one procedure id; optionally narrow by name, unit, specialty, professional, patient or price table. GET /procedures/list.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Part of the procedure name."
},
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
},
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Prices for this patient (their price table / insurance).",
"exclusiveMinimum": 0
},
"procedure_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "One procedure id (use when no type is given).",
"exclusiveMinimum": 0
},
"specialty_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"price_table_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Private price table id.",
"exclusiveMinimum": 0
},
"professional_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"procedure_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Procedure type id (feegow_list_procedure_types).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List procedures",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| location_id |
| integer |
| procedure_id | integer |
| specialty_id | integer |
| appointment_id | integer | One appointment id; then the dates are optional. |
| professional_id | integer |
{
"name": "feegow_list_appointments",
"title": "List appointments",
"description": "Appointments in a date range (or one appointment by id), filtered by professional, patient, unit, location, specialty, channel, procedure or status. Paged: pass the previous reply's next_start. Health data: contains patient ids. GET /appoints/search.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"start": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Position of the first row (default 0). Use next_start from the previous reply."
},
"date_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day, yyyy-mm-dd. Required unless appointment_id is given."
},
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
},
"date_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day, yyyy-mm-dd. Required unless appointment_id is given."
},
"is_return": {
"type": "boolean",
"description": "true = only return visits (retorno)."
},
"page_size": {
"type": "integer",
"maximum": 200,
"description": "Rows per page, 1-200 (default 50).",
"exclusiveMinimum": 0
},
"channel_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Booking channel id (feegow_list_booking_channels).",
"exclusiveMinimum": 0
},
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"status_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 20,
"minItems": 1,
"description": "Only these statuses (feegow_list_appointment_statuses), e.g. [1, 7] for booked."
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"procedure_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"specialty_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"appointment_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "One appointment id; then the dates are optional.",
"exclusiveMinimum": 0
},
"professional_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List appointments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| integer |
{
"name": "feegow_get_available_schedule",
"title": "Find open appointment slots",
"description": "Free appointment times for a specialty or a procedure between two dates, optionally for one professional, unit or insurance. Use before feegow_create_appointment. GET /appoints/available-schedule.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"kind",
"date_from",
"date_to"
],
"properties": {
"kind": {
"enum": [
"specialty",
"procedure"
],
"type": "string",
"description": "What to search by: a specialty or a procedure."
},
"age_to": {
"type": "integer",
"maximum": 130,
"minimum": 0,
"description": "Patient's maximum age."
},
"date_to": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Unit (branch) id. 0 = the main clinic (matriz). Omit for all units where the endpoint allows it. See feegow_list_units."
},
"age_from": {
"type": "integer",
"maximum": 130,
"minimum": 0,
"description": "Patient's minimum age."
},
"date_from": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
},
"insurance_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Insurance (convênio) id; see feegow_list_insurances.",
"exclusiveMinimum": 0
},
"procedure_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Required when kind is procedure.",
"exclusiveMinimum": 0
},
"specialty_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Required when kind is specialty.",
"exclusiveMinimum": 0
},
"professional_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Find open appointment slots",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| Location (room) id; see feegow_list_locations. 0 = default. |
| value_cents * | integer | Price in CENTS (e.g. R$ 550.00 = 55000). Must be 0 when using insurance. |
| insurance_id | integer | Insurance (convênio) id: set it, with insurance_plan_id, to book under insurance. |
| procedure_id * | integer |
| specialty_id * | integer |
| price_table_id | integer | Private price table id. |
| professional_id * | integer |
| insurance_plan_id | integer | Plan id of the insurance. Required with insurance_id. |
{
"name": "feegow_create_appointment",
"title": "Create appointment",
"description": "WRITE: books a new appointment in the clinic's agenda (not in the past). Check feegow_get_available_schedule first; a taken slot or unknown patient is refused. Feegow may notify the patient (SMS/e-mail/WhatsApp) according to the clinic's own automation settings. valor is in CENTS and must be 0 with insurance. POST /appoints/new-appoint.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"patient_id",
"professional_id",
"specialty_id",
"procedure_id",
"location_id",
"date",
"time",
"value_cents"
],
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Appointment day, yyyy-mm-dd (today or later)."
},
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
"description": "Time of day, 24 h, HH:MM or HH:MM:SS."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Patient e-mail."
},
"notes": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Appointment note."
},
"phone": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Patient phone."
},
"mobile": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Patient mobile phone."
},
"is_return": {
"type": "boolean",
"description": "true = a return visit (retorno)."
},
"channel_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Booking channel id (feegow_list_booking_channels).",
"exclusiveMinimum": 0
},
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Location (room) id; see feegow_list_locations. 0 = default."
},
"value_cents": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "Price in CENTS (e.g. R$ 550.00 = 55000). Must be 0 when using insurance."
},
"insurance_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Insurance (convênio) id: set it, with insurance_plan_id, to book under insurance.",
"exclusiveMinimum": 0
},
"procedure_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"specialty_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"price_table_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Private price table id.",
"exclusiveMinimum": 0
},
"professional_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"insurance_plan_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Plan id of the insurance. Required with insurance_id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create appointment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| true = the patient has no CPF (then cpf is ignored). |
| number | string | Street number. |
| phone2 | string | Second phone, digits only. |
| address | string | Street. |
| mobile2 | string | Second mobile phone, digits only. |
| district | string | District (bairro). |
| full_name * | string | Full name (max 200 characters). |
| source_id | integer | Patient source id (feegow_list_patient_sources). |
| birth_date | string | Birth date, yyyy-mm-dd. |
| complement | string | Address complement. |
| social_name | string | Social name. |
| insurance_id | integer | Insurance (convênio) id. |
| insurance_card | string | Insurance card number (matrícula). |
| price_table_id | integer | Private price table id. |
| insurance_holder | string | Insurance holder's name. |
| insurance_plan_id | integer | Insurance plan id. |
| insurance_valid_until | string | Insurance validity, yyyy-mm-dd. |
{
"name": "feegow_create_patient",
"title": "Create patient",
"description": "WRITE: registers a new patient and returns the patient_id. Feegow does not duplicate: when a patient with the same CPF and birth date (or, without a CPF, the same name plus mobile, e-mail or birth date) exists, that patient's id is returned and nothing is created. Set no_cpf=true for a patient without CPF. Health data (LGPD): only register data the patient gave the clinic. POST /patient/create.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"full_name"
],
"properties": {
"cpf": {
"type": "string",
"pattern": "^\\d{1,11}$",
"description": "CPF, 11 digits, numbers only."
},
"zip": {
"type": "string",
"maxLength": 9,
"minLength": 1,
"description": "CEP (max 9 characters)."
},
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "City."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "E-mail."
},
"notes": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Note on the patient record."
},
"phone": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Phone, digits only."
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 1,
"description": "State, two letters (e.g. RJ)."
},
"email2": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Second e-mail."
},
"gender": {
"enum": [
"M",
"F"
],
"type": "string",
"description": "M or F."
},
"mobile": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Mobile phone, digits only."
},
"no_cpf": {
"type": "boolean",
"description": "true = the patient has no CPF (then cpf is ignored)."
},
"number": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Street number."
},
"phone2": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Second phone, digits only."
},
"address": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Street."
},
"mobile2": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Second mobile phone, digits only."
},
"district": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "District (bairro)."
},
"full_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Full name (max 200 characters)."
},
"source_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Patient source id (feegow_list_patient_sources).",
"exclusiveMinimum": 0
},
"birth_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Birth date, yyyy-mm-dd."
},
"complement": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Address complement."
},
"social_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Social name."
},
"insurance_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Insurance (convênio) id.",
"exclusiveMinimum": 0
},
"insurance_card": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Insurance card number (matrícula)."
},
"price_table_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Private price table id.",
"exclusiveMinimum": 0
},
"insurance_holder": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Insurance holder's name."
},
"insurance_plan_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Insurance plan id.",
"exclusiveMinimum": 0
},
"insurance_valid_until": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Insurance validity, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Create patient",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| string |
| Street. |
| mobile2 | string | Second mobile phone, digits only. |
| district | string | District (bairro). |
| full_name | string | Full name (max 200 characters). |
| birth_date | string | Birth date, yyyy-mm-dd. |
| complement | string | Address complement. |
| patient_id * | integer |
| price_table_id | integer | Private price table id. |
{
"name": "feegow_update_patient",
"title": "Update patient",
"description": "WRITE: changes a patient's registration data. Only the fields you pass are sent; they overwrite stored values. CPF can only be set when absent, never replaced after registration (vendor rejects a different existing CPF). Health data (LGPD). Feegow caches reads for 5 minutes (use fresh=true in feegow_get_patient to see the change). POST /patient/edit.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"patient_id"
],
"properties": {
"cpf": {
"type": "string",
"pattern": "^\\d{1,11}$",
"description": "CPF, 11 digits, numbers only."
},
"zip": {
"type": "string",
"maxLength": 9,
"minLength": 1,
"description": "CEP (max 9 characters)."
},
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "City."
},
"email": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "E-mail."
},
"phone": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Phone, digits only."
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 1,
"description": "State, two letters (e.g. RJ)."
},
"gender": {
"enum": [
"M",
"F"
],
"type": "string",
"description": "M or F."
},
"mobile": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Mobile phone, digits only."
},
"number": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Street number."
},
"phone2": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Second phone, digits only."
},
"address": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Street."
},
"mobile2": {
"type": "string",
"pattern": "^\\d{1,20}$",
"description": "Second mobile phone, digits only."
},
"district": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "District (bairro)."
},
"full_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Full name (max 200 characters)."
},
"birth_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Birth date, yyyy-mm-dd."
},
"complement": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Address complement."
},
"patient_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"price_table_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Private price table id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update patient",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}