# WebDiet — how to use (mcp.ai)

Gestão de pacientes, planos alimentares, prescrições, prontuário e antropometria para nutricionistas.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_webdiet?ms=1781045040000`
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. `webdiet_anamnese`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/webdiet`
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/webdiet/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/webdiet/anamnese` — List all anamnesis records for a WebDiet patient WITH the full Q/A content.
  - body: { patient_id: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/anamnese/delete` — Permanently delete an anamnesis record in WebDiet. Irreversible.
  - body: { patient_id: string, anamnese_id: string, account?: string, patient_ids?: string[], anamnese_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/anamnese/write/duplicate` — Create / update anamnesis records in WebDiet.
  - body: { patient_id: string, anamnese_id?: string, texto?: string, titulo?: string, interpretacao?: string, account?: string, patient_ids?: string[], anamnese_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/anamnese/write/save` — Create / update anamnesis records in WebDiet.
  - body: { patient_id: string, anamnese_id?: string, texto?: string, titulo?: string, interpretacao?: string, account?: string, patient_ids?: string[], anamnese_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/anamnese/write/save/interpretation` — Create / update anamnesis records in WebDiet.
  - body: { patient_id: string, anamnese_id?: string, texto?: string, titulo?: string, interpretacao?: string, account?: string, patient_ids?: string[], anamnese_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/antropometria/get` — Read anthropometry (body measurement) records for a WebDiet patient.
  - body: { patient_id?: string, antropometria_id?: string, account?: string, patient_ids?: string[], antropometria_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/antropometria/list` — Read anthropometry (body measurement) records for a WebDiet patient.
  - body: { patient_id?: string, antropometria_id?: string, account?: string, patient_ids?: string[], antropometria_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/calculo/energetico/delete` — Permanently delete an energy expenditure calculation. Irreversible.
  - body: { calculo_id: string, account?: string, calculo_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/calculo/energetico/get` — Read energy expenditure calculations (Cálculo Energético) in WebDiet.
  - body: { patient_id?: string, calculo_id?: string, account?: string, patient_ids?: string[], calculo_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/calculo/energetico/list` — Read energy expenditure calculations (Cálculo Energético) in WebDiet.
  - body: { patient_id?: string, calculo_id?: string, account?: string, patient_ids?: string[], calculo_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/calculo/energetico/write/create` — Create / update energy expenditure calculations in WebDiet.
  - body: { patient_id: string, calculo_id?: string, nome?: string, altura?: string, peso?: string, mlg?: string, formula?: string, fator_atividade?: string, fator_injuria?: string, account?: string, patient_ids?: string[], calculo_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/calculo/energetico/write/save` — Create / update energy expenditure calculations in WebDiet.
  - body: { patient_id: string, calculo_id?: string, nome?: string, altura?: string, peso?: string, mlg?: string, formula?: string, fator_atividade?: string, fator_injuria?: string, account?: string, patient_ids?: string[], calculo_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/create/antropometria` — Create a new body measurement record for a patient. Returns the record ID needed for webdiet_save_antropometria. Types: adulto (adult), infantil (child), gestacional (pregnancy).
  - body: { patient_id: string, tipo?: string, data?: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/financeiro/categories` — Read financial records (payments, receipts) in WebDiet.
  - body: { inicio?: string, fim?: string, tipo?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/financeiro/delete` — Permanently delete a financial record. Irreversible.
  - body: { financeiro_id: string, account?: string, financeiro_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/financeiro/list` — Read financial records (payments, receipts) in WebDiet.
  - body: { inicio?: string, fim?: string, tipo?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/financeiro/write` — Create financial records in WebDiet.
  - body: { patient_id: string, nome?: string, cpf?: string, tipo?: string, data?: string, horario?: string, categoria?: string, nova_cat?: string, valor: string, forma?: string, observacao?: string, parcelas?: string, dataCobranca?: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/food/search` — Search WebDiet food database for numeric food ids (needed for full macros in Convencional / metodoPlanning prescriptions).
  - body: { keyword: string, limite?: number, account?: string }
- `POST https://api.mcp.ai/api/webdiet/get/consultations` — Load food diary entries, meal reactions, attachments, or orientations for a patient. Use tipo to select: diario (food diary), reacoes (meal reactions), anexos (attachments), orientacoes (guidelines/or
  - body: { patient_id: string, tipo?: string, limite?: number, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/get/planner` — Load the nutritionist's calendar/agenda for a date: appointments, overdue tasks, birthdays, events. Defaults to today.
  - body: { date?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/get/upload/command` — Returns a ready-to-run curl command that uploads a file directly to the server without reading it into context.
  - body: { file_path: string, file_name?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/list/accounts` — List all WebDiet accounts linked to this install.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/webdiet/list/anexos` — Load educational slides or cloud file attachments. Use laminasAnexos for educational slides/laminas (~238 items with PDFs about nutrition topics), cloudAnexos for uploaded cloud files. For guidelines/
  - body: { patient_id?: string, tipo?: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/list/message/templates` — Load patient welcome message templates. Returns the active layout and all available template layouts.
  - body: { tipo?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/manipulados/delete` — Permanently delete a manipulado for a patient. Irreversible.
  - body: { patient_id: string, manipulado_id: string, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/get` — Read "Prescrição de manipulados" (compounded/magistral pharmacy formulas) in WebDiet.
  - body: { patient_id?: string, manipulado_id?: string, keyword?: string, categoria?: string, incluir_bloqueados?: boolean, limite?: number, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/list` — Read "Prescrição de manipulados" (compounded/magistral pharmacy formulas) in WebDiet.
  - body: { patient_id?: string, manipulado_id?: string, keyword?: string, categoria?: string, incluir_bloqueados?: boolean, limite?: number, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/list/banco` — Read "Prescrição de manipulados" (compounded/magistral pharmacy formulas) in WebDiet.
  - body: { patient_id?: string, manipulado_id?: string, keyword?: string, categoria?: string, incluir_bloqueados?: boolean, limite?: number, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/write/duplicate` — Create / send / publish / duplicate manipulados in WebDiet.
  - body: { patient_id: string, manipulado_id?: string, nome?: string, texto?: string, nomes?: string, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/write/publish` — Create / send / publish / duplicate manipulados in WebDiet.
  - body: { patient_id: string, manipulado_id?: string, nome?: string, texto?: string, nomes?: string, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/write/save` — Create / send / publish / duplicate manipulados in WebDiet.
  - body: { patient_id: string, manipulado_id?: string, nome?: string, texto?: string, nomes?: string, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/manipulados/write/send` — Create / send / publish / duplicate manipulados in WebDiet.
  - body: { patient_id: string, manipulado_id?: string, nome?: string, texto?: string, nomes?: string, account?: string, patient_ids?: string[], manipulado_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/orientacoes/list` — Read "Listas e Orientações" (guidelines/orientation lists) in WebDiet.
  - body: { patient_id?: string, limite?: number, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/orientacoes/list/banco` — Read "Listas e Orientações" (guidelines/orientation lists) in WebDiet.
  - body: { patient_id?: string, limite?: number, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/orientacoes/write/save` — Create / update / send "Listas e Orientações" in WebDiet.
  - body: { patient_id: string, orientacao_id?: string, texto?: string, titulo?: string, nomes?: string, account?: string, patient_ids?: string[], orientacao_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/orientacoes/write/send` — Create / update / send "Listas e Orientações" in WebDiet.
  - body: { patient_id: string, orientacao_id?: string, texto?: string, titulo?: string, nomes?: string, account?: string, patient_ids?: string[], orientacao_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/patient/delete` — Permanently delete a WebDiet patient (uses removerPaciente — resolves id/link from a fresh list first). Irreversible.
  - body: { patient_id: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/patient/get` — Read patients in WebDiet.
  - body: { patient_id?: string, keyword?: string, page?: integer, page_size?: integer, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/patient/list` — Read patients in WebDiet.
  - body: { patient_id?: string, keyword?: string, page?: integer, page_size?: integer, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/patient/write/create` — Create or update patients in WebDiet.
  - body: { patient_id?: string, nome?: string, genero?: string, nascimento?: string, telefone?: string, email?: string, cpf?: string, apelido?: string, instagram?: string, boasvindas?: boolean, cep?: string, endereco?: string, bairro?: string, cidade?: string, estado?: string, complemento?: string, numero?: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/patient/write/update` — Create or update patients in WebDiet.
  - body: { patient_id?: string, nome?: string, genero?: string, nascimento?: string, telefone?: string, email?: string, cpf?: string, apelido?: string, instagram?: string, boasvindas?: boolean, cep?: string, endereco?: string, bairro?: string, cidade?: string, estado?: string, complemento?: string, numero?: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/preconsulta/delete` — Permanently delete a pre-consultation response in WebDiet. Templates are NOT affected. Irreversible.
  - body: { response_id: string, account?: string, response_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/preconsulta/get/response` — Read pre-consultation questionnaires (Pré-consulta) in WebDiet.
  - body: { response_id?: string, tipo?: string, nome?: string, offset?: integer, limit?: integer, account?: string, response_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/preconsulta/list/responses` — Read pre-consultation questionnaires (Pré-consulta) in WebDiet.
  - body: { response_id?: string, tipo?: string, nome?: string, offset?: integer, limit?: integer, account?: string, response_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/preconsulta/list/templates` — Read pre-consultation questionnaires (Pré-consulta) in WebDiet.
  - body: { response_id?: string, tipo?: string, nome?: string, offset?: integer, limit?: integer, account?: string, response_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/preconsulta/write/link/to/patient` — Vincular (link) a pre-consultation response to an existing patient in WebDiet.
  - body: { patient_id: string, response_id: string, account?: string, patient_ids?: string[], response_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/prescription/get/detail` — Read meal plan prescriptions in WebDiet.
  - body: { link?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/prescription/list` — Read meal plan prescriptions in WebDiet.
  - body: { link?: string, account?: string }
- `POST https://api.mcp.ai/api/webdiet/prescription/write/create` — Create, save or publish meal plan prescriptions in WebDiet.
  - body: { patient_id: string, prescription_id?: string, nome?: string, metodo?: string, prescricao_json?: string, account?: string, patient_ids?: string[], prescription_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/prescription/write/publish` — Create, save or publish meal plan prescriptions in WebDiet.
  - body: { patient_id: string, prescription_id?: string, nome?: string, metodo?: string, prescricao_json?: string, account?: string, patient_ids?: string[], prescription_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/prescription/write/save` — Create, save or publish meal plan prescriptions in WebDiet.
  - body: { patient_id: string, prescription_id?: string, nome?: string, metodo?: string, prescricao_json?: string, account?: string, patient_ids?: string[], prescription_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/prontuario` — Get the clinical record (prontuario) for a WebDiet patient. Returns decoded text with sections: Identificacao, Triagem, Anamnese alimentar, etc.
  - body: { patient_id: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/prontuario/write` — Save the clinical record (prontuario) for a WebDiet patient. Pass texto as a JSON array of HTML strings, one per section.
  - body: { patient_id: string, texto: string, account?: string, patient_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/recibo` — Generate or update a receipt (recibo) for a financial record in WebDiet.
  - body: { financeiro_id: string, nome: string, dados_recibo?: string, account?: string, financeiro_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/save/antropometria` — Save body measurements (anthropometry) for a patient. Call webdiet_create_antropometria first to get the antropometria_id.
  - body: { patient_id: string, antropometria_id: string, massa?: string, estatura?: string, estatura_sentado?: string, altura_joelho?: string, dobra_triceptal?: string, dobra_biciptal?: string, dobra_abdominal?: string, dobra_subescapular?: string, dobra_axilar?: string, dobra_coxa?: string, dobra_toraxica?: string, dobra_suprailiaca?: string, dobra_panturrilha?: string, dobra_supraespinhal?: string, c_pescoco?: string, c_torax?: string, c_ombro?: string, c_cintura?: string, c_abdomen?: string, c_quadril?: string, c_bracorelaxado?: string, c_bracorelaxado_dir?: string, c_bracocontraido?: string, c_bracocontraido_dir?: string, c_antebraco?: string, c_antebraco_dir?: string, c_coxaproximal?: string, c_coxaproximal_dir?: string, c_coxamedial?: string, c_coxamedial_dir?: string, c_coxadistal?: string, c_coxadistal_dir?: string, c_panturrilha?: string, c_panturrilha_dir?: string, diametro_umero?: string, diametro_punho?: string, diametro_femur?: string, formula_escolhida?: string, refAntropometria?: string, lado?: string, bioimpedancia_agua?: string, bioimpedancia_massa?: string, bioimpedancia_gordura?: string, bioimpedancia_osseo?: string, bioimpedancia_massalivre?: string, bioimpedancia_idade?: string, bioimpedancia_visceral?: string, bioimpedancia_massaGordura?: string, bioimpedancia_percentualMagra?: string, origem?: string, account?: string, patient_ids?: string[], antropometria_ids?: string[] }
- `POST https://api.mcp.ai/api/webdiet/upload/anexo` — Upload a file (PDF, image, etc.) to a patient's attachments in WebDiet.
  - body: { patient_id: string, upload_code?: string, file_url?: string, file_base64?: string, file_name?: string, tipo?: string, nome_anexo?: string, salvar_cloud?: boolean, account?: string, patient_ids?: string[] }

## Example prompts
- "Liste meus pacientes e a próxima consulta de cada um"
- "Crie uma prescrição alimentar de 1800 kcal pra paciente Maria"
- "Busque alimentos com alta proteína no banco TACO"

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