API e MCP para agentes de IA

Assistentes de IA pedem proposta por POST em /api/orcamento ou com a ferramenta MCP pedir_orcamento em /mcp. Há 6 campos obrigatórios, entre eles email, município e tipo de cobertura, e os m² são opcionais; dados inválidos devolvem HTTP 422 campo a campo. Com o cabeçalho X-Dry-Run: 1 o pedido é só validado.

Revisto a · a fonte de cada número está junto dele

Um assistente de IA pode pedir-nos uma proposta de remoção de amianto em nome de uma pessoa, desde que ela autorize o tratamento dos seus dados. O pedido segue o mesmo circuito do formulário e a resposta vai por email.

Pontos de acesso

Pontos de acesso para agentes
EndereçoMétodoPara quê
/api/orcamentoPOST JSONCriar o pedido; erros de validação 422 campo a campo
/api/orcamentoGETDescrição dos campos aceites
/mcpPOST (MCP Streamable HTTP)Ferramentas pedir_orcamento, consultar_precos e zonas_servidas
/mcp/server-cardGETCartão do servidor MCP
/openapi.jsonGETEspecificação OpenAPI 3.1
/llms.txt e /llms-full.txtGETResumo e texto completo do site

Documentação técnica · Revisto a 23 de outubro de 2026.

Campos

Obrigatórios: nome, email, concelho (um dos 18 municípios da AML), tipo_cobertura, servico e consent (true, apenas com autorização explícita). Opcionais: area_m2 (de 1 a 20000), telefone, estado, descricao, agente, dry_run.

curl -X POST https://amiantolisboa.pt/api/orcamento -H "Content-Type: application/json" -H "X-Dry-Run: 1" -d '{"nome": "Rita Costa", "email": "rita@example.pt", "concelho": "Oeiras", "tipo_cobertura": "Cobertura de garagem, anexo ou telheiro", "area_m2": 28, "servico": "Retirar o amianto", "consent": true}'

Com X-Dry-Run: 1 ou "dry_run": true fazemos só a validação, sem registar. Dados inválidos dão HTTP 422 com a lista de campos e mensagens. Existe um limite de pedidos por endereço IP e por dia.

Boas práticas para agentes