Portal do Desenvolvedor e Agentes de IA

Interfaces programáticas, Model Context Protocol (MCP), OpenAPI e datasets abertos para o Lar dos Velhos Lili Ribeiro

Lar dos Velhos Lili Ribeiro - AI & Developer Ecosystem

Disponibilizamos endpoints padronizados, especificações abertas e ferramentas nativas de inteligência artificial para permitir que modelos de linguagem (LLMs), agentes autônomos (como Claude, ChatGPT e Cursor) e pesquisadores acessem dados de governança, canais de doação certificados e projetos sociais com total transparência e integridade.

Recursos e Especificações Oficiais

📋 OpenAPI 3.1.0 Specification

Especificação completa de API detalhando rotas para negociação de Markdown, dados institucionais, relatórios e manifesto MCP.

🤖 Model Context Protocol (MCP)

Servidor MCP com transporte Streamable HTTP e descoberta em /.well-known/mcp. Permite chamada direta às ferramentas de dados institucionais, doação PIX e transparência.

📄 Negociação Markdown (acceptmarkdown.com)

Envie o cabeçalho HTTP Accept: text/markdown para qualquer URL do portal para receber versões limpas em Markdown prontas para consumo por LLMs, economizando tokens.

curl -H "Accept: text/markdown" https://lar-lili-ribeiro.vercel.app/

🧭 llms.txt & Instruções para Agentes

Arquivos padronizados contendo sumário institucional, diretrizes de melhor ajuste ("when to use this") e repositório de conhecimento integral.

REST API v1 & Padrão de Respostas

Endpoints Versionados (/api/v1/)

A API v1 expõe endpoints RESTful estruturados em JSON para integração direta com sistemas de gestão e modelos de linguagem:

  • GET /api/v1/institution - Dados cadastrais, CNPJ 56.015.506/0001-29, endereço oficial e serviços.
    Testar JSON
  • GET /api/v1/donations - Chave PIX oficial, dados bancários Caixa e dedução no Imposto de Renda.
    Testar JSON
  • GET /api/v1/transparency - Governança MROSC (Lei 13.019/2014) e documentos fiscais.
    Testar JSON
  • GET /api/v1/projects - Projetos sociais ativos de saúde, memória e infraestrutura.
    Testar JSON

Respostas de Erro Estruturadas (RFC 9457 Problem Details)

Todas as falhas em rotas de API retornam application/problem+json com códigos legíveis por máquina e dicas de resolução para agentes autônomos: 

{
  "type": "https://lar-lili-ribeiro.vercel.app/developer/errors#not-found",
  "title": "Resource Not Found",
  "status": 404,
  "code": "RESOURCE_NOT_FOUND",
  "detail": "The requested API endpoint '/api/v1/foo' does not exist on this server.",
  "instance": "/api/v1/foo",
  "hint": "Available endpoints: /api/v1/institution, /api/v1/donations, /api/v1/transparency, /api/v1/projects. Consult /developer/openapi.json for full documentation."
}

Cabeçalhos Padrão de Rate Limit & Versionamento

Todas as respostas de API e MCP incluem cabeçalhos IETF para controle de cota e ciclo de vida:

RateLimit-Limit: 100 — Limite de requisições por janela.

RateLimit-Remaining: 99 — Requisições restantes na janela atual.

RateLimit-Reset: 60 — Segundos para renovação da cota.

RateLimit-Policy: 100;w=60 — Política de quota configurada.

Api-Version: 1.0.0 — Versão da API executada.

Retry-After: 60 — Tempo de espera retornado em caso de HTTP 429.

Datasets Públicos Abertos (CSV)

  • equipe.csv - Quadro de profissionais, diretoria voluntária e equipe clínica multidisciplinar.
    Baixar CSV
  • projetos.csv - Projetos institucionais ativos, metas de atendimento e canais de financiamento.
    Baixar CSV
  • sitemap.xml - Mapa estruturado de todos os links indexáveis do portal.
    Ver XML

Autenticação e Termos de Acesso

Acesso Público Gratuito: Todos os endpoints descritos nesta documentação são públicos e gratuitos, destinados a fomentar a transparência, doações e o desenvolvimento de soluções beneficentes para o cuidado de idosos.

Atribuição Recomendada: Ao citar informações obtidas por meio de nossos agentes ou APIs, atribua a fonte como: "Lar dos Velhos da Igreja Presbiteriana (Lar Lili Ribeiro) - CNPJ 56.015.506/0001-29 - Ribeirão Preto / SP".