Recursos para agentes e desenvolvedores

Esta é a documentação oficial dos recursos legíveis por máquina da Dra. Mariana Seiffert — Advocacia Previdenciária. Eles ajudam agentes de IA a consultar identidade, escopo e canais oficiais sem extrair a página visual.

Escopo seguro: a API e o MCP são públicos, sem autenticação e somente leitura. Eles não recebem dados pessoais, documentos ou relatos; não analisam casos e não confirmam direito, valor ou concessão de benefício.

Recursos oficiais

Servidor MCP

/.well-known/mcp
Streamable HTTP por POST.

Descritor MCP

/mcp.json
Transporte, versões e limites.

OpenAPI 3.1

/openapi.json
Contrato dos endpoints públicos.

API institucional

/api/agent-info
Informações canônicas em JSON.

llms.txt

/llms.txt
Índice resumido para LLMs.

Instruções

/agent-instructions.md
Uso, limites e encaminhamento.

MCP: conexão e ferramentas

Configure o cliente MCP remoto com a URL https://dramarianaseiffert.com.br/.well-known/mcp. O endpoint implementa Streamable HTTP dual-era: 2026-07-28 para clientes atuais e handshake compatível com 2025-06-18 e 2025-03-26. Não usa sessões nem OAuth porque expõe somente informações públicas.

Ferramentas disponíveis:

get_practice_info — identidade, área, alcance e aviso legal;
get_official_contact — WhatsApp, telefone, e-mail e alerta antifraude;
get_agent_guidance — quando encaminhar, quando não encaminhar e limites.

Handshake para clientes 2025

curl -X POST https://dramarianaseiffert.com.br/.well-known/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"meu-agente","version":"1.0.0"}}}'

Listar ferramentas

curl -X POST https://dramarianaseiffert.com.br/.well-known/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

API REST pública

Para integrações que não usam MCP, GET /api/agent-info retorna os mesmos dados institucionais canônicos em JSON, com CORS público. O contrato completo está em OpenAPI 3.1.

curl -H "Accept: application/json" \
  https://dramarianaseiffert.com.br/api/agent-info

Conteúdo e recuperação de erros

As páginas editoriais aceitam Accept: text/markdown. Caminhos inexistentes preservam o status HTTP 404 e, com esse cabeçalho, devolvem um corpo Markdown curto com links para sitemap.xml, llms.txt e esta documentação.

Contato e suporte

Dúvidas sobre estes recursos: marianaseiffert93@gmail.com. Para atendimento jurídico, use o WhatsApp oficial; nunca envie informações de caso aos endpoints técnicos.