# Fred & Theo Browneria — informações para agentes

A Fred & Theo é uma browneria para pedidos de brownies em Cascavel e região. O canal de atendimento é o WhatsApp **+55 (45) 99118-6877**. Sabores, preços, quantidades, ingredientes e condições de entrega ou retirada devem ser confirmados com a equipe.

## Interfaces públicas

- `GET https://fredetheo.com.br/api/business`: identidade da marca, contatos, área de atendimento e perguntas frequentes extraídos do conteúdo do site.
- `GET https://fredetheo.com.br/api/health`: disponibilidade da interface pública.
- `GET https://fredetheo.com.br/api/whatsapp-link?topic=menu`: prepara um link de consulta. Temas aceitos: `menu`, `gift`, `event`, `ingredients`.
- `POST https://fredetheo.com.br/mcp`: servidor MCP público, sem sessão, usando Streamable HTTP com respostas JSON.
- `GET https://fredetheo.com.br/` com `Accept: text/markdown`: versão Markdown da página inicial. Requisições de navegadores continuam recebendo HTML.

## MCP e WebMCP

Ferramentas disponíveis:

- `get_business_info`: consulta as informações públicas da marca.
- `prepare_whatsapp_link`: recebe `topic` opcional e retorna o link para o WhatsApp. O padrão é `menu`.

O servidor MCP também oferece o recurso `https://fredetheo.com.br/api/business`. Ele pode ser consultado com `resources/list` e `resources/read`. Clientes devem inicializar a conexão conforme o protocolo MCP. O endpoint aceita POST com `Content-Type: application/json` e `Accept: application/json, text/event-stream`. Não há stream SSE persistente nem sessão armazenada.

Navegadores com WebMCP recebem as mesmas duas ferramentas no carregamento. A aplicação detecta `document.modelContext` e, para versões anteriores, `navigator.modelContext`. Navegadores sem essa API continuam funcionando normalmente; não é publicado um objeto falso para simular suporte.

## Pedidos e limites

As ferramentas preparam links e consultam informações. Elas não enviam mensagens, não fazem pagamentos e não confirmam pedidos. Antes de abrir um link externo, respeite a autorização do visitante. A confirmação da compra acontece na conversa com a equipe, pelo WhatsApp.

Não inferir endereço físico, estado, horários, preços, disponibilidade, prazos, entrega grátis ou opções sem alérgenos. Perguntar à equipe quando essas informações forem necessárias. O site não representa um agente A2A nem oferece checkout automatizado.

## Autenticação

Esses recursos são públicos e não exigem conta, token ou cadastro de agentes. Não existem endpoints OAuth/OIDC, chaves JWT ou recursos protegidos. Consulte `/auth.md` para o escopo desse acesso público.

## Descoberta

- Catálogo de APIs RFC 9727: `/.well-known/api-catalog`.
- OpenAPI 3.1: `/openapi.json`.
- Catálogo de capacidades: `/.well-known/ai-catalog.json`.
- MCP Server Card atual: `/mcp/server-card`.
- Card de compatibilidade com verificadores anteriores: `/.well-known/mcp/server-card.json`.
- Skills: `/.well-known/agent-skills/index.json`.
- Resumo: `/llms.txt`.

As interfaces são exclusivamente informativas e não são uma fonte de estoque ou preços em tempo real.
