Nigeria Postcode MCP Server

What this does

Nigeria Postcode exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

NG_POSTCODE_API_KEY
NG_POSTCODE_MAX_LEVEL
NG_POSTCODE_MAX_PAID_CALLS
NG_POSTCODE_BASE_URL
NG_GEOCODER_URL
NG_GEOCODER_CONTACT
NG_POSTCODE_TRANSPORT
NG_POSTCODE_HOST
NG_POSTCODE_PORT
NG_POSTCODE_ALLOW_SHARED_KEY
NG_POSTCODE_ALLOWED_HOSTS

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

How do I install Nigeria Postcode?

Run the Claude Code command in the install section to add Nigeria Postcode to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with Nigeria Postcode?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to Nigeria Postcode as well.

Does Nigeria Postcode need an API key?

Yes. Before it can run, set these environment variables: NG_POSTCODE_API_KEY, NG_POSTCODE_MAX_LEVEL, NG_POSTCODE_MAX_PAID_CALLS, NG_POSTCODE_BASE_URL, NG_GEOCODER_URL, NG_GEOCODER_CONTACT, NG_POSTCODE_TRANSPORT, NG_POSTCODE_HOST, NG_POSTCODE_PORT, NG_POSTCODE_ALLOW_SHARED_KEY, NG_POSTCODE_ALLOWED_HOSTS. They go in the env block of your MCP config.