mcp · Global

ng-postcode

Validate Nigerian postcodes in Rust, Python, JavaScript, Java, PostgreSQL, DuckDB, and Polars, with MCP servers for AI agents. Covers Nigeria's NIPOST digital postcode (NDAPS): offline validation, lookup, and reverse geocoding.

Visit source ↗GitHub repository ↗

Claim this listing

Represent ng-postcode? Send a claim for review so we can discuss listing updates. Claims do not automatically grant ownership or verification.

Explore paid sponsorship →

What's in it

Data offered docs-verified: postcode parsing and validation (offline) · postcode lookup (NIPOST API, key required) · postcode autocomplete (NIPOST API, key required) · find postcode by location (NIPOST API, key required) · free-text address resolution to postcode (pre-release) · postcode formatting and grouping by state, LGA, district and area · CSV validation with status, suggested correction and invalid reason
Coverage docs-verified: Nigeria
Resolution docs-verified: Building-level postcode: 11-character code in five segments (state, LGA, district, area, building unit)
Formats llm-inferred: CSV · JSON · MCP stdio
Access docs-verified: Offline parsing and validation need no key; API-backed tools need a NIPOST developer dashboard key; licence MIT

Useful for

Use cases llm-inferred: Validate and standardise Nigerian site or client addresses in a CSV register before import · Group Nigerian asset or site records by district or area code in PostgreSQL or DuckDB · Pass a location reference between an AI agent and a GIS or data workflow using the postcode reference schema
Audience llm-inferred: GIS analysts · data engineers · planners

Limitations

Constraints llm-inferred: Covers Nigerian postcodes only; not applicable to UK addressing · Address resolver and resolve_address tool are pre-release; accuracy on real addresses is unmeasured · API needs a key for every endpoint; lookup levels 2 and up need a higher-access key and are tested only against documented examples · A well-formed code is not necessarily assigned to a building; only the NIPOST API can confirm that · Node MCP server (npx) does not include address resolution · DuckDB extension must be built from a separate repository; PostgreSQL native extension needs install rights on the server · Live API behaviour may differ from documentation; see docs/api-differences.md

Licence: MIT
Authentication: API key via env: NG_POSTCODE_API_KEY (auto-extracted from README)
GitHub stars: 4
Last commit: 14/10/2026
Last successful page check: 14/10/2026
Page health: healthy
Package: pypi:ng-postcode
Verification: Not independently verified

Auto-extracted, unverified fields: tools, install, auth. Check upstream documentation.

Provenance & evidence

Tools/install/auth auto-extracted from README; quality score heuristic (stars, recency, tool count, licence).

Metadata observed 15/10/2026 · research sweep: github-search