Para assistentes de IA

Servidor MCP

Endereço: https://www.iflora.com.br/care/mcp

• Transporte Streamable HTTP, sem estado (respostas JSON, sem SSE). Versões do protocolo: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.
• tools/list e initialize/server/discover funcionam sem chave.
• Chave de API gratuita e instantânea com a ferramenta register_agent. Envie a chave no cabeçalho Authorization: Bearer … ou no argumento api_key.

Fluxo

1. register_agent uma vez; guarde a chave.
2. start_request com só três respostas: quem precisa de cuidado, idade e localização (estado + município). Não peça mais nada antes. O pedido fica salvo e voltam os prestadores compatíveis.
3. Mostre as opções à família; use get_provider para ver o cadastro completo de um prestador, com o status de cada informação.
4. Quando a família escolher até 3, faça as perguntas restantes (onde a pessoa está, mobilidade, memória, quando começar, pagamento), mostre os textos de consentimento e peça o contato. Então chame send_request.
5. get_request_status mostra as respostas dos prestadores (até 2 dias úteis) e novas opções se todos recusarem.

Privacidade (LGPD): dados de saúde só com o consentimento da família; o contato da família só vai para prestadores que aceitarem o caso. A iFlora Care verifica informações declaradas pelos prestadores, não a qualidade do cuidado nem a disponibilidade de vagas.

API HTTP

As mesmas funções em https://www.iflora.com.br/care/api/v1. Especificação: openapi.json.

POST /agents                          register_agent
POST /requests                        start_request
GET  /requests/{ref}/providers/{id}   get_provider
POST /requests/{ref}/send             send_request
GET  /requests/{ref}                  get_request_status

Sem ferramentas? Envie um link

Se você não pode chamar ferramentas, envie à família um link para o formulário, já preenchido com o que ela contou:

https://www.iflora.com.br/care/solicitar?quem=parent&idade=84&uf=SP&municipio=Campinas&tipo=senior_living

Parâmetros: quem (spouse, parent, self, other), idade, uf, municipio, bairro, tipo (home_care, senior_living, both), distancia (under_15, 15_30, 30_50, over_50, same_municipality).

Ferramentas

register_agent — Get an iFlora Care API key

Returns a free iFlora Care API key instantly. Call this once, keep the key, and reuse it for every later call. No family information is needed. iFlora Care (iflora.com.br) helps families in Brazil find home care companies and senior residences (ILPIs, casas de repouso, residenciais sêniores) anywhere in the country.

start_request — Describe the care need and get matching providers

Step 1 of 2. Find home care companies and/or senior residences for an older person in Brazil. Only THREE answers are needed now: who needs care (relationship), their age, and where (state + municipality). Do not ask anything else before calling; if the family already mentioned other details (care setting, distance, mobility, memory loss...), include them, otherwise leave them out. iFlora Care saves the request and returns matching providers, ranked. Do NOT include names, phone numbers or emails.

Each answer is {"value": ..., "source": "family_confirmed" | "agent_filled"} (family_confirmed if the family said it). Health details (mobility, memory, clinical needs, etc.) are sensitive data under Brazilian law (LGPD): only include them if the family agreed to this text, shown in Portuguese: "Autorizo a iFlora Care a usar as informações de saúde e de cuidado que compartilhei para encontrar prestadores de cuidado compatíveis. Meu nome e meus contatos não são pedidos nesta etapa." — then also send processing_consent=true and processing_consent_text_version="processing-v1-2026-10". Talk to the family in Portuguese.

Results: "assumptions" says what was assumed (e.g. residences within 30 km). Requirements labelled "não confirmado" mean the provider has not yet confirmed it offers what the family needs. stale=true means not re-checked in 6 months. iFlora Care verifies facts stated by providers (licenses, registrations, services offered); it does not assess care quality or guarantee availability. If nothing matches, say so plainly and offer the suggestions returned; the request stays saved. next_step lists the remaining questions to ask only when the family is ready to send the case.

get_provider — Read one matched provider in full

Full record of one provider returned by start_request (or by get_request_status next_options) for this public_ref: every fact with its status (verified, unverified, self-declared, unknown), source type and date. Only providers that matched this request can be read. iFlora Care verifies facts stated by providers (licenses, registrations, services offered); it does not assess care quality or guarantee availability.

send_request — Send the anonymized case to up to 3 providers

Step 2 of 2, after the family has seen the matches and chosen 1 to 3 providers. iFlora Care sends each chosen provider an anonymized case card and contacts it; providers answer within 2 business days. The family's name, phone/WhatsApp and email are shared ONLY with providers that accept the case.

NOW ask the remaining questions (listed in start_request next_step.questions_still_needed): where the person is now, mobility, memory loss, when care should start and how it will be paid; optionally daily help needed, behaviors, clinical needs, schedule and professional type. Put the answers in qualification (same format as start_request).

PRIVACY: show the family, in Portuguese, the consent texts and send only if they agree: (1) unless already given at start_request, processing: "Autorizo a iFlora Care a usar as informações de saúde e de cuidado que compartilhei para encontrar prestadores de cuidado compatíveis. Meu nome e meus contatos não são pedidos nesta etapa." -> processing_consent=true, processing_consent_text_version="processing-v1-2026-10"; (2) sharing: "Autorizo a iFlora Care a enviar meu caso, sem meu nome, aos prestadores que escolhi, e a passar meu nome, telefone/WhatsApp e e-mail somente aos que aceitarem o caso." -> sharing_consent=true, sharing_consent_text_version="sharing-v1-2026-10". Ask for their contact details; never invent them. If warnings come back, tell the family. Use get_request_status later.

get_request_status — Follow the providers' answers

Status of each case card of a request: pending, contacting, accepted, declined (with reason) or expired (no answer within 2 business days, counted as declined). When every provider declined or expired, next_options lists other matching providers the family can choose (send them with send_request). Only the agent that created the request can read it.