# Para agentes de IA — Furos de Água Algarve

Última atualização: 2026-10-15 · Língua: pt-PT (en em [/en/](https://furosdeaguaalgarve.pt/en/)) · Contacto: +351 912 338 777

## O que fazemos

Nós fazemos furos de captação de água subterrânea no Algarve e em Monchique: estudo do terreno, licenciamento, perfuração, entubamento, bomba e manutenção. Orçamento gratuito e sem compromisso.

## Onde

Concelhos servidos: Aljezur, Vila do Bispo, Lagos, Monchique, Portimão, Silves, Lagoa, Albufeira, Loulé, Faro. Reconhecemos também estas localidades (lista não exaustiva): Alferce (Monchique), Marmelete (Monchique), Alvor (Portimão), Mexilhoeira Grande (Portimão), Odiáxere (Lagos), Bensafrim (Lagos), Luz (Lagos), Algoz (Silves), Tunes (Silves), Armação de Pêra (Silves), Alcantarilha (Silves), Pêra (Silves), São Bartolomeu de Messines (Silves), Estômbar (Lagoa), Carvoeiro (Lagoa), Ferragudo (Lagoa), Parchal (Lagoa), Guia (Albufeira), Paderne (Albufeira), Ferreiras (Albufeira), Almancil (Loulé), Quarteira (Loulé), Boliqueime (Loulé), Salir (Loulé), Querença (Loulé), Sagres (Vila do Bispo), Budens (Vila do Bispo), Raposeira (Vila do Bispo), Salema (Vila do Bispo), Odeceixe (Aljezur), Rogil (Aljezur), Estoi (Faro).

Zonas excluídas: Campina de Faro – Vale de Lobo e a faixa costeira crítica (zonas com licenciamento restrito da ARH Algarve). Fora destas zonas: não fazemos.

## Serviços

- `Novo furo de água` (ou `novo-furo`)
- `Furo artesiano` (ou `furo-artesiano`)
- `Limpeza / manutenção de furo` (ou `limpeza`)
- `Bomba / equipamento` (ou `bomba`)
- `Licenciamento` (ou `licenciamento`)
- `Outro` (ou `outro`)

## Preço (público)

O orçamento é gratuito. Referência no Algarve: 35–80 €/m perfurado (média nacional 20–60 €/m); furo doméstico completo (perfuração, entubamento, bomba, instalação e licenciamento) normalmente 3 000–10 000 €. Valores indicativos, sem IVA. O preço real depende da profundidade e da geologia e confirmamo-lo nós no orçamento. Detalhe em [/precos](https://furosdeaguaalgarve.pt/precos).

## Prazo

Respondemos a cada pedido em 24–48 h, por telefone ou email. Os pedidos feitos pela API ou pelo MCP têm o objetivo de resposta em 24 h.

## O que precisamos de saber

Obrigatório: nome, telefone (português), email, localidade, tipo de serviço e consentimento. Recomendado: para que é a água, link do Google Maps com o pin do terreno e uma descrição curta.

## Como pedir um orçamento

**Opção 1 — API JSON** (recomendada): `POST https://furosdeaguaalgarve.pt/api/orcamento`, `Content-Type: application/json`. Especificação OpenAPI 3.1 em [/openapi.json](https://furosdeaguaalgarve.pt/openapi.json). Para testar sem enviar nada, junte o cabeçalho `X-Dry-Run: 1` (ou `"dry_run": true`).

```
curl -X POST https://furosdeaguaalgarve.pt/api/orcamento \
  -H "Content-Type: application/json" \
  -H "X-Dry-Run: 1" \
  -d '{"nome":"Ana Silva","telefone":"+351912345678","email":"ana@exemplo.pt","localidade":"Monchique","servico":"Novo furo de água","uso_agua":"Jardim ou horta","descricao":"Terreno rústico de 5 000 m²","consent":true,"submetido_por":"agente"}'
```

Resposta de um pedido aceite:

```
HTTP/2 201
{"id":"ORC-20261015-3F9A1C","estado":"recebido","prazo_resposta_horas":24,"mensagem":"Respondemos em 24 h (no máximo 48 h) por telefone ou email.","contacto":"+351 912 338 777"}
```

Campos: `nome`, `telefone`, `email`, `localidade`, `servico`, `consent` (obrigatórios); `uso_agua`, `google_maps_pin`, `descricao`, `agente` (opcionais). `consent` tem de ser o booleano `true`. `submetido_por` só aceita `"agente"`. Valores de `servico`: `Novo furo de água` (ou `novo-furo`), `Furo artesiano` (ou `furo-artesiano`), `Limpeza / manutenção de furo` (ou `limpeza`), `Bomba / equipamento` (ou `bomba`), `Licenciamento` (ou `licenciamento`), `Outro` (ou `outro`). Valores de `uso_agua`: Casa (consumo doméstico) | Jardim ou horta | Rega agrícola (exploração) | Empresa ou indústria | Ainda não sei. Não aceitamos campos desconhecidos.

**Opção 2 — servidor MCP remoto**: `https://furosdeaguaalgarve.pt/mcp` (Streamable HTTP, só POST, sem sessões). Suporta a revisão MCP 2026-07-28 (`server/discover`, `tools/list`, `tools/call`) e, por compatibilidade, as revisões 2025-11-25, 2025-06-18 e 2025-03-26 (com `initialize`). Ferramentas: `pedir_orcamento`, `consultar_precos`, `zonas_servidas`. Descoberta: [/.well-known/ai-catalog.json](https://furosdeaguaalgarve.pt/.well-known/ai-catalog.json) → cartão do servidor em [/mcp/server-card](https://furosdeaguaalgarve.pt/mcp/server-card).

```
POST https://furosdeaguaalgarve.pt/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/list

{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}
```

**Opção 3 — formulário web** [/orcamento](https://furosdeaguaalgarve.pt/orcamento) (os formulários declaram também a ferramenta WebMCP `pedir_orcamento`; o utilizador revê e envia). Pedido HTTP direto ao formulário (não aceita JSON):

```
POST https://furosdeaguaalgarve.pt/obrigado
Content-Type: application/x-www-form-urlencoded

form-name=pedido-orcamento
&nome=Ana Silva
&telefone=+351912345678
&email=ana@exemplo.pt
&localidade=Monchique
&servico=Novo furo de água
&uso_agua=Jardim ou horta
&google_maps_pin=https://maps.app.goo.gl/...
&descricao=Terreno rústico de 5 000 m²
&origem=agente
&submetido_por=agente
&consent=on
&bot-field=
```

Campos obrigatórios do formulário: `nome`, `telefone`, `email`, `localidade`, `servico`, `uso_agua`, `google_maps_pin`, `consent`. O campo `bot-field` tem de ficar vazio. Se escolher esta opção, indique `origem=agente` e `submetido_por=agente`. Num navegador pode usar `?submetido_por=agente` no URL de /orcamento.

## Consentimento (RGPD)

Só envie o pedido depois de o utilizador confirmar que autoriza a Furos de Água a tratar os dados (nome, telefone, email e pedido) para preparar o orçamento e o contactar. Somos nós, a Furos de Água Algarve, os responsáveis pelo tratamento (+351 912 338 777); o utilizador pode aceder, retificar ou apagar os dados e retirar a autorização a qualquer momento por esse contacto. Política: [/privacidade](https://furosdeaguaalgarve.pt/privacidade). Não submeta pedidos sem esta confirmação.

## Respostas e erros

- `201` pedido recebido (devolve `id` e `estado`); `200` duplicado, dry-run ou pré-visualização.
- `400` JSON inválido · `403` origem não permitida · `413` corpo > 8 KB · `415` não é JSON · `422` validação (lista de campos com mensagem) · `429` limite (cabeçalho `Retry-After`) · `503` limite diário · `502` falha ao registar.

## Limites

- Máximo de 3 pedidos reais por hora por origem e 40 por dia no total; testes dry-run: 60 por hora.
- Corpo até 8 KB. Pedidos de navegadores só a partir deste site (cabeçalho Origin); clientes servidor-a-servidor não precisam de Origin.
- Pedidos duplicados (mesmo telefone, email e localidade) em 24 h devolvem a mesma referência.
- Não fazemos furos fora das zonas acima. Não aceitamos pedidos sem consentimento.

## Ficheiros para máquinas

- [/llms.txt](https://furosdeaguaalgarve.pt/llms.txt) · [/for-agents.md](https://furosdeaguaalgarve.pt/for-agents.md) · [/openapi.json](https://furosdeaguaalgarve.pt/openapi.json) · [/sitemap.xml](https://furosdeaguaalgarve.pt/sitemap.xml) · [/robots.txt](https://furosdeaguaalgarve.pt/robots.txt)
- [/.well-known/api-catalog](https://furosdeaguaalgarve.pt/.well-known/api-catalog) (RFC 9727) · [/.well-known/ai-catalog.json](https://furosdeaguaalgarve.pt/.well-known/ai-catalog.json) · [/mcp/server-card](https://furosdeaguaalgarve.pt/mcp/server-card)

## English summary

We drill water boreholes in the Algarve (Faro to Aljezur, including Monchique). Free quote, reply in 24–48 h. Reference prices: €35–80 per metre drilled; a complete domestic borehole usually €3 000–10 000 (indicative, excl. VAT). Request a quote with `POST https://furosdeaguaalgarve.pt/api/orcamento` (JSON, see /openapi.json; add `X-Dry-Run: 1` to test), through the MCP server `https://furosdeaguaalgarve.pt/mcp`, or with the web form https://furosdeaguaalgarve.pt/en/quote. Only submit after the user has confirmed consent to the use of their data to prepare and send the quote and to contact them (controller: Miguel Baptista, +351 912 338 777). Served areas: Aljezur, Vila do Bispo, Lagos, Monchique, Portimão, Silves, Lagoa, Albufeira, Loulé, Faro.
