AI Address Resolution

How AI assistants, search engines, and developers resolve Sahal Digital Address codes.

Sahal Address Code Format

Sahal address codes use a structured format such as MG-HW-B0001:

  • MG — identifies Mogadishu (the city)
  • HW — identifies the district / area code
  • B0001 — identifies the building / address record

Public Address Pages

Every valid address code has a permanent, public, crawlable URL — no login required:

https://sahal-addresses.base44.app/address/MG-HW-B0001

Each page includes SEO meta tags, canonical URL, and JSON-LD structured data (schema.org Place) so search engines and AI crawlers can understand it.

Public Read-Only API

Resolve any Sahal code to a JSON record with a single GET request:

GET https://sahal-addresses.base44.app/functions/addressApi?code=MG-HW-B0001

Example response:

{
  "code": "MG-HW-B0001",
  "system": "Sahal Digital Address",
  "country": "Somalia",
  "city": "Mogadishu",
  "district": "Hodan",
  "building": "B0001",
  "latitude": 2.05,
  "longitude": 45.32,
  "address_url": "https://sahal-addresses.base44.app/address/MG-HW-B0001",
  "map_url": "https://www.google.com/maps/search/?api=1&query=2.05,45.32"
}

Unknown codes return HTTP 404 with "Address code not found." — coordinates are never invented.

MCP Server (for ChatGPT, Claude, Cursor)

Connect your AI assistant to Sahal via a public, read-only MCP server:

https://sahal-addresses.base44.app/api/mcp

Add it as a Streamable HTTP MCP server (no API key needed). Primary tool:

query_building  →  filter by address_code to resolve a Sahal address

Also available: query_city, query_district, query_googleplacemapping, query_facility, and other public directory tools.

Security & Read-Only

  • All public endpoints and MCP tools are strictly read-only.
  • No create, update, or delete operations are exposed.
  • Private resident information, credentials, and non-public records are never exposed.
  • Coordinates are only returned when they exist in the database.

Try It

Sahal Digital Address System · Somalia · Developer Docs