# Feegow Clinic — how to use (mcp.ai)

Gestão completa de clínicas no Feegow Clinic, pacientes, agendamentos, profissionais, especialidades, convênios, financeiro, prontuário eletrônico, propostas e cartão de benefícios. Autenticação por token de acesso (x-access-token) gerado em Configurações → API.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_feegow?ms=1781044800000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `feegow_appointment_available_schedule`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/feegow`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/feegow/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/feegow/appointment/available/schedule` — Read appointments and scheduling data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/channels` — Read appointments and scheduling data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/list` — Read appointments and scheduling data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/motives` — Read appointments and scheduling data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/queue/position` — Read appointments and scheduling data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/statuses` — Read appointments and scheduling data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/write/cancel` — Create, cancel, reschedule, or update status of appointments in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/write/create` — Create, cancel, reschedule, or update status of appointments in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/write/reschedule` — Create, cancel, reschedule, or update status of appointments in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/appointment/write/update/status` — Create, cancel, reschedule, or update status of appointments in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/benefit/card/list/contracts` — Read benefit card data in Feegow (contracts and plans).
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/benefit/card/list/plans` — Read benefit card data in Feegow (contracts and plans).
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/benefit/card/write/create/contract` — Write benefit card operations in Feegow (contracts and plans).
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/benefit/card/write/create/plan` — Write benefit card operations in Feegow (contracts and plans).
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/benefit/card/write/update/contract` — Write benefit card operations in Feegow (contracts and plans).
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/benefit/card/write/update/plan` — Write benefit card operations in Feegow (contracts and plans).
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/billing` — Read insurance billing guides (guias) in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/billing/write/create` — Create or edit insurance billing guides in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/billing/write/edit` — Create or edit insurance billing guides in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/company/list/locals` — Read clinic company info in Feegow.
  - body: { endereco?: string, cep?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/company/list/units` — Read clinic company info in Feegow.
  - body: { endereco?: string, cep?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/employee` — List employees in Feegow. Requires ativo (0=inactive, 1=active). Optional: unidade_id.
  - body: { ativo?: number, unidade_id?: number, account?: string, unidade_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/financial/delete/cancel/voucher` — Destructive financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/delete/remove/invoice` — Destructive financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/delete/remove/payment` — Destructive financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/find/invoice/nfse` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/get/dmed` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/categories` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/cost/centers` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/credit/card/brands` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/current/accounts` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/invoices` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/private/tables` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/sales` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/suppliers` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/transfers` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/list/vouchers` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/search/supplier` — Read financial data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/associate/account` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/create/invoice` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/create/invoice/by/appt` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/create/voucher` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/pay/booking` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/pay/invoice` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/update/nfse` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/financial/write/update/voucher` — Write financial operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/insurance` — List all accepted insurance plans (convênios) and their sub-plans in Feegow. Optional filter by unidade_id.
  - body: { unidade_id?: number, account?: string, unidade_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/list/accounts` — List Feegow API connections (clinics) linked to this install — id, label, name.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/feegow/lock` — List schedule locks/blocks in Feegow. Filter by bloqueio_id, date_start, date_end (DD-MM-YYYY), profissional_id, unidade_id.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/medical/report/get/file` — Read medical/lab reports (laudos) in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/medical/report/list` — Read medical/lab reports (laudos) in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/medical/report/search` — Read medical/lab reports (laudos) in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/medical/report/write` — Register a new medical/lab report in Feegow. Requires agendamento_id, laudo_base64. Optional: profissional_laudador, procedimento_id.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/patient/get` — Read patients in Feegow Clinic.
  - body: { paciente_id?: number, cpf?: string, limit?: number, offset?: number, telefone?: string, origem_id?: number, alterado_em?: string, data_aniversario?: string, programa_saude?: boolean, photo?: boolean, account?: string, paciente_ids?: number[], origem_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/list` — Read patients in Feegow Clinic.
  - body: { paciente_id?: number, cpf?: string, limit?: number, offset?: number, telefone?: string, origem_id?: number, alterado_em?: string, data_aniversario?: string, programa_saude?: boolean, photo?: boolean, account?: string, paciente_ids?: number[], origem_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/search/cpf` — Read patients in Feegow Clinic.
  - body: { paciente_id?: number, cpf?: string, limit?: number, offset?: number, telefone?: string, origem_id?: number, alterado_em?: string, data_aniversario?: string, programa_saude?: boolean, photo?: boolean, account?: string, paciente_ids?: number[], origem_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/support/exam/requests` — Supporting patient data reads in Feegow.
  - body: { paciente_id?: number, data?: string, account?: string, paciente_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/support/health/programs` — Supporting patient data reads in Feegow.
  - body: { paciente_id?: number, data?: string, account?: string, paciente_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/support/list/dependents` — Supporting patient data reads in Feegow.
  - body: { paciente_id?: number, data?: string, account?: string, paciente_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/support/list/privates` — Supporting patient data reads in Feegow.
  - body: { paciente_id?: number, data?: string, account?: string, paciente_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/support/list/sources` — Supporting patient data reads in Feegow.
  - body: { paciente_id?: number, data?: string, account?: string, paciente_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/patient/support/write` — Upload a base64 file to a patient record in Feegow. Requires data JSON with paciente_id or cpf+nascimento, base64_file, arquivo_descricao.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/patient/write/create` — Create or edit patients in Feegow Clinic.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/patient/write/edit` — Create or edit patients in Feegow Clinic.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/procedure/bundles` — Read procedures in Feegow. Values in centavos.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/procedure/franchise` — Read procedures in Feegow. Values in centavos.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/procedure/groups` — Read procedures in Feegow. Values in centavos.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/procedure/insurance/list` — Read procedures in Feegow. Values in centavos.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/procedure/list` — Read procedures in Feegow. Values in centavos.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/procedure/types` — Read procedures in Feegow. Values in centavos.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/professional/get` — Read professionals (doctors, specialists) in Feegow.
  - body: { profissional_id?: number, ativo?: number, unidade_id?: number, especialidade_id?: number, account?: string, profissional_ids?: number[], unidade_ids?: number[], especialidade_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/professional/insurance` — Read professionals (doctors, specialists) in Feegow.
  - body: { profissional_id?: number, ativo?: number, unidade_id?: number, especialidade_id?: number, account?: string, profissional_ids?: number[], unidade_ids?: number[], especialidade_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/professional/list` — Read professionals (doctors, specialists) in Feegow.
  - body: { profissional_id?: number, ativo?: number, unidade_id?: number, especialidade_id?: number, account?: string, profissional_ids?: number[], unidade_ids?: number[], especialidade_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/proposal/get/url` — Read proposals (treatment plans with pricing) in Feegow. Values in R$.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/proposal/list` — Read proposals (treatment plans with pricing) in Feegow. Values in R$.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/proposal/list/by/date` — Read proposals (treatment plans with pricing) in Feegow. Values in R$.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/proposal/write/change/status` — Create / update proposals in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/proposal/write/create` — Create / update proposals in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/report/generate` — List and generate system reports in Feegow.
  - body: { report?: string, DATA_INICIO?: string, DATA_FIM?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/report/list` — List and generate system reports in Feegow.
  - body: { report?: string, DATA_INICIO?: string, DATA_FIM?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/specialty` — List all medical specialties available for scheduling in Feegow. Optional filter by unidade_id.
  - body: { unidade_id?: number, account?: string, unidade_ids?: number[] }
- `POST https://api.mcp.ai/api/feegow/stock/get/position` — Read stock/inventory data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/stock/list/locations` — Read stock/inventory data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/stock/list/products` — Read stock/inventory data in Feegow.
  - body: { data?: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/stock/write/entry` — Write stock operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/stock/write/exit` — Write stock operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/stock/write/insert` — Write stock operations in Feegow.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/feegow/stock/write/movement` — Write stock operations in Feegow.
  - body: { data: string, account?: string }

## Example prompts
- "Liste os agendamentos de hoje por profissional"
- "Mostre o financeiro da clínica nos últimos 30 dias"
- "Busque um paciente pelo CPF e abra o prontuário"

## More
- Page: https://mcp.ai/feegow
- Agent spec (llms.txt): https://mcp.ai/feegow/llms.txt
- Postman collection: https://mcp.ai/feegow/postman.json