Home › Other › Nigeria Postcode

Nigeria Postcode

Validate, look up and resolve addresses to Nigeria's NIPOST digital postcodes (NDAPS).

Python Cloud macOSWindowsLinux

★ 6 stars Last pushed 2026-10-24 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (pypi 0.6.3)

uvx ng-postcode-mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "ng-postcode": {
      "command": "uvx",
      "args": [
        "ng-postcode-mcp"
      ],
      "env": {
        "NG_POSTCODE_API_KEY": "<YOUR_VALUE>",
        "NG_POSTCODE_MAX_LEVEL": "<YOUR_VALUE>",
        "NG_POSTCODE_MAX_PAID_CALLS": "<YOUR_VALUE>",
        "NG_POSTCODE_BASE_URL": "<YOUR_VALUE>",
        "NG_GEOCODER_URL": "<YOUR_VALUE>",
        "NG_GEOCODER_CONTACT": "<YOUR_VALUE>",
        "NG_POSTCODE_TRANSPORT": "<YOUR_VALUE>",
        "NG_POSTCODE_HOST": "<YOUR_VALUE>",
        "NG_POSTCODE_PORT": "<YOUR_VALUE>",
        "NG_POSTCODE_ALLOW_SHARED_KEY": "<YOUR_VALUE>",
        "NG_POSTCODE_ALLOWED_HOSTS": "<YOUR_VALUE>"
      }
    }
  }
}

NG_POSTCODE_API_KEY secret — NIPOST Postcode API key from dashboard.postcode.gov.ng. Validation works without it.
NG_POSTCODE_MAX_LEVEL — Highest lookup level tools may request. Levels 2 and up consume NIPOST credits.
NG_POSTCODE_MAX_PAID_CALLS — How many paid lookups one run of the server may make with its own key.
NG_POSTCODE_BASE_URL — Alternative API host, such as a staging stack.
NG_GEOCODER_URL — Nominatim server used by resolve_address to place described addresses. Ideally your own instance.
NG_GEOCODER_CONTACT — URL or email identifying you to the geocoder. Required for the public Nominatim.
NG_POSTCODE_TRANSPORT — stdio (default), or http to serve streamable HTTP at /mcp on NG_POSTCODE_HOST and NG_POSTCODE_PORT.
NG_POSTCODE_HOST — Address the HTTP transport listens on.
NG_POSTCODE_PORT — Port the HTTP transport listens on.
NG_POSTCODE_ALLOW_SHARED_KEY — Set to 1 to let the HTTP transport start with a server key on a public address.
NG_POSTCODE_ALLOWED_HOSTS — Host names the HTTP transport answers to, separated by commas. Required with a server key on a public address.

Package (npm 0.4.2)

npx -y [email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "ng-postcode": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "NG_POSTCODE_API_KEY": "<YOUR_VALUE>",
        "NG_POSTCODE_MAX_LEVEL": "<YOUR_VALUE>",
        "NG_POSTCODE_MAX_PAID_CALLS": "<YOUR_VALUE>",
        "NG_POSTCODE_BASE_URL": "<YOUR_VALUE>"
      }
    }
  }
}

NG_POSTCODE_API_KEY secret — NIPOST Postcode API key from dashboard.postcode.gov.ng. Validation works without it.
NG_POSTCODE_MAX_LEVEL — Highest lookup level tools may request. Levels 2 and up consume NIPOST credits.
NG_POSTCODE_MAX_PAID_CALLS — How many paid lookups one run of the server may make with its own key.
NG_POSTCODE_BASE_URL — Alternative API host, such as a staging stack.