A agenda por dentro.
Ferramentas MCP
A sua IA enxerga só as ferramentas que o papel de quem pede permite.
Ler
Visão do dia, busca por período e paciente, horários livres, profissionais que atendem o procedimento, histórico e resumo do período.
- agendamento_visao_dia
- agendamento_find
- agendamento_find_available_slots
- agendamento_find_professional_options
- agendamento_get_historico
- agendamento_summarize
Agir
Marcar, remarcar, cancelar, mudar o estado, registrar a resposta do paciente, bloquear, abrir extras e cuidar da lista de espera.
- agendamento_book_appointment
- agendamento_reschedule
- agendamento_cancel
- agendamento_change_state
- agendamento_registrar_rsvp
- agendamento_manage_block
- agendamento_manage_extra_slot
- agendamento_manage_waitlist
Prever
Encaixe recomendado pela previsão de faltas e quem da lista de espera serve para uma vaga.
- agendamento_overbooking_recomendacao
- agendamento_waitlist_matches
A semana montada
"Monta a minha semana que vem." A IA soma as consultas por dia, aponta quem pode faltar, acha onde cabe encaixe e abre o horário extra depois de mostrar a prévia.
Gravações do sistema numa clínica de demonstração, com dados fictícios (inclusive a previsão do tempo do dia gravado).
API REST
Para integração sem IA: token da integração e chamadas HTTP. A referência completa vem com o acesso que a clínica concede.
Agenda por período
Consultas com status, confirmação, resposta do paciente e chance de vagar, paginadas.
- GET /agendamento/
O ciclo da consulta
Confirmar, chegou, faltou, finalizar, remarcar e cancelar são ações próprias, cada uma com a sua permissão.
- POST /agendamento/{id}/confirmar
- POST /agendamento/{id}/chegou
- POST /agendamento/{id}/faltou
- POST /agendamento/{id}/finalizar
- POST /agendamento/{id}/reagendar
- POST /agendamento/{id}/cancelar
Grade e ocupação
Horários disponíveis, a vitrine pública do site e a ocupação por período.
- GET /slots/
- GET /slots/publico
- GET /slots/ocupacao
token = post(AUTH, {"grant_type": "client_credentials",
"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET})["access_token"]
agenda = get(f"{API}/agendamento/", token, params={
"data_inicio": "2026-10-23T00:00:00-03:00",
"data_fim": "2026-10-23T23:59:59-03:00",
"sort_by": "data_inicio", "per_page": 100,
})["data"]
for c in agenda:
vagar = (c["risco_noshow"] or 0) + (c["risco_cancelamento_tardio"] or 0)
print(c["data_inicio"], c["status"], f"{vagar:.0%}")Eventos e permissões
Cada mudança vira evento
Consulta marcada, confirmada, remarcada, cancelada, falta e finalizada. Exemplo: agendamento.agendamento_criado dispara um time de agentes.
Sem texto livre no evento
O evento leva referências e estado, não o motivo nem as anotações da consulta.
A previsão volta como campo
Um agente de previsão calcula a chance de falta e de cancelamento tardio, com os fatores, e grava no próprio agendamento.
Uma permissão por ação
agendamento:list, create, reschedule, cancel, noshow, confirm, arrive, rsvp… O papel de quem pede decide o que passa.
Negar por padrão
Permissão nova se registra quando o serviço sobe e começa desligada para todos; quem concede é a clínica, na Central.
Peça à sua IA
Pela conexão MCP, a IA que a clínica preferir age com as permissões de quem pediu: só faz o que essa pessoa pode fazer na Central.
Segurança para médicos builders- "Monta a minha semana que vem: consultas por dia, quem pode faltar e onde cabe encaixe."agendamento_find · agendamento_overbooking_recomendacao
- "Cria uma tarefa para ligar para cada paciente de sexta com risco alto que ainda não confirmou."agendamento_find · tarefas_create
- "Todo dia útil às 8h, cria uma tarefa para a recepção ligar para quem tem risco alto e não confirmou."designer_agentes_validar_manifesto
