API · MCP · PORTUGAL

PDM para agentes e aplicações

Da localização à classificação do solo, RAN, REN e parâmetros disponíveis. Uma resposta estruturada, com fontes e avisos, pronta a integrar no seu fluxo de trabalho.

Um ponto confirmado. Uma consulta. Um crédito.

O titular compra créditos com o pagamento Stripe habitual e cria uma chave com orçamento. O agente consulta autonomamente dentro desse limite. Sem subscrição nem carregamento automático.

Sem cobrança quando não há classificação PDM ou só existe uma estimativa de ocupação do solo (COS). Repetir o mesmo pedido com o mesmo identificador não volta a gastar créditos.

Ligar em minutos

1. Crie conta, compre créditos e guarde uma chave API abaixo.
2. Ligue por OAuth num cliente MCP compatível, ou configure uma chave Bearer no servidor https://pdmfacil.pt/mcp num cliente com suporte a cabeçalhos Bearer, ou utilize a API REST.
3. Pesquise a morada gratuitamente. Confirme com o utilizador as coordenadas WGS84 do terreno antes da consulta paga.
4. Apresente o resultado com as fontes, limitações e avisos devolvidos.

curl https://pdmfacil.pt/api/v1/agent \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $PDMFACIL_API_KEY" \
  -d '{"operation":"query_pdm","arguments":{
    "lat":39.744,"lng":-8.807,
    "idempotency_key":"leiria-pedido-001"
  }}'

Use um identificador novo para cada compra e conserve-o nas tentativas de repetição. A resposta dispensa imagens para reduzir o tempo e o volume de dados.

O que o agente deve saber

Uma morada pode ter vários candidatos. O centro de uma rua ou concelho não identifica uma parcela. A consulta descreve um ponto e não substitui a confirmação da câmara municipal.

A resposta inclui classificação, parâmetros quando disponíveis, fontes, data da consulta e avisos de cobertura. Serviços oficiais podem estar indisponíveis; dados em falta não significam ausência de restrições.

O acesso atual utiliza chaves API e créditos pré-pagos. Clientes MCP com OAuth podem pedir autorização ao titular, com um limite de créditos e acesso revogável durante 30 dias. São suportados clientes de servidor e desktop; ligações diretas de páginas web de terceiros não estão disponíveis. x402 e MPP não estão ativos; o código 402 indica que o titular deve repor saldo ou rever o limite da chave.