Moradas API beta

GET /suggest

GET /suggest?q=estrada malveira da serra 920&count=8

{ "suggestions": [ {
    "value": "Estrada Malveira da Serra, Malveira da Serra",
    "data": {
      "art_id": 125340, "kind": "street",
      "street": "Estrada Malveira da Serra", "localidade": "Malveira da Serra",
      "concelho": "Cascais", "distrito": "Lisboa",
      "cp7": "2755-332", "nseg": 1,
      "numero": "920", "resolved_cp7": "2755-332"
  } }, {
    "value": "Estrada Malveira da Serra, Aldeia de Juzo",
    "data": {
      "art_id": 125968, "kind": "street",
      "street": "Estrada Malveira da Serra", "localidade": "Aldeia de Juzo",
      "concelho": "Cascais", "distrito": "Lisboa",
      "cp7": "2750-834", "nseg": 11,
      "numero": "920", "resolved_cp7": "2750-834"
  } }, … ] }

q
count

GET /resolve

GET /resolve?art=129377&numero=196

{ "resolved": { "value": "Avenida da Liberdade, Lisboa",
                "data": { ..., "cp7": "1250-147" } },
  "segments": [ { "cp7": "1250-139", "label": "Impares de 1 a 57" }, ... ] }

GET /cp/{cp7}

GET /cp/1000-098

{ "cp7": "1000-098", "cp4": "1000", "cp3": "098",
  "distrito": "Lisboa", "concelho": "Lisboa", "localidade": "Lisboa",
  "arterias": [ { "art_id": ..., "street": "Praça do Chile", ... } ] }

POST /feedback

POST /feedback
Content-Type: application/json

{ "query": "rua que não apareceu, localidade", "note": "optional details" }

Endpoint:   https://moradas.dev/mcp   (Streamable HTTP, stateless)
Tools:      suggest_address · resolve_postal_code · postal_code_info

Claude Code:
  claude mcp add --transport http moradas https://moradas.dev/mcp

Cursor / Windsurf / others (mcp.json):
  { "mcpServers": { "moradas": { "url": "https://moradas.dev/mcp" } } }