Search / io.github.Adeniyikayodee/ng-postcode
Nigeria Postcode
L0· runs locallyValidate, look up and resolve addresses to Nigeria's NIPOST digital postcodes (NDAPS).
v0.6.3 · active · repository · descriptor JSON · versions
Search / io.github.Adeniyikayodee/ng-postcode
L0· runs locallyValidate, look up and resolve addresses to Nigeria's NIPOST digital postcodes (NDAPS).
v0.6.3 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"ng-postcode": {
"command": "uvx",
"args": [
"ng-postcode-mcp==0.6.3"
],
"env": {
"NG_POSTCODE_API_KEY": "${NG_POSTCODE_API_KEY}",
"NG_POSTCODE_MAX_LEVEL": "1",
"NG_POSTCODE_MAX_PAID_CALLS": "25",
"NG_POSTCODE_BASE_URL": "https://api.postcode.gov.ng",
"NG_POSTCODE_TRANSPORT": "stdio",
"NG_POSTCODE_HOST": "127.0.0.1",
"NG_POSTCODE_PORT": "8000"
}
}
}
}claude mcp add ng-postcode -e "NG_POSTCODE_API_KEY=${NG_POSTCODE_API_KEY}" -e "NG_POSTCODE_MAX_LEVEL=1" -e "NG_POSTCODE_MAX_PAID_CALLS=25" -e "NG_POSTCODE_BASE_URL=https://api.postcode.gov.ng" -e "NG_POSTCODE_TRANSPORT=stdio" -e "NG_POSTCODE_HOST=127.0.0.1" -e "NG_POSTCODE_PORT=8000" -- uvx ng-postcode-mcp==0.6.3[mcp_servers.ng-postcode]
command = "uvx"
args = ["ng-postcode-mcp==0.6.3"]
env = { "NG_POSTCODE_API_KEY" = "${NG_POSTCODE_API_KEY}", "NG_POSTCODE_MAX_LEVEL" = "1", "NG_POSTCODE_MAX_PAID_CALLS" = "25", "NG_POSTCODE_BASE_URL" = "https://api.postcode.gov.ng", "NG_POSTCODE_TRANSPORT" = "stdio", "NG_POSTCODE_HOST" = "127.0.0.1", "NG_POSTCODE_PORT" = "8000" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ng-postcode": {
"type": "local",
"command": [
"uvx",
"ng-postcode-mcp==0.6.3"
],
"enabled": true,
"environment": {
"NG_POSTCODE_API_KEY": "{env:NG_POSTCODE_API_KEY}",
"NG_POSTCODE_MAX_LEVEL": "1",
"NG_POSTCODE_MAX_PAID_CALLS": "25",
"NG_POSTCODE_BASE_URL": "https://api.postcode.gov.ng",
"NG_POSTCODE_TRANSPORT": "stdio",
"NG_POSTCODE_HOST": "127.0.0.1",
"NG_POSTCODE_PORT": "8000"
}
}
}
}{
"mcpServers": {
"ng-postcode": {
"command": "uvx",
"args": [
"ng-postcode-mcp==0.6.3"
],
"env": {
"NG_POSTCODE_API_KEY": "${NG_POSTCODE_API_KEY}",
"NG_POSTCODE_MAX_LEVEL": "1",
"NG_POSTCODE_MAX_PAID_CALLS": "25",
"NG_POSTCODE_BASE_URL": "https://api.postcode.gov.ng",
"NG_POSTCODE_TRANSPORT": "stdio",
"NG_POSTCODE_HOST": "127.0.0.1",
"NG_POSTCODE_PORT": "8000"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ng-postcode&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJuZy1wb3N0Y29kZS1tY3A9PTAuNi4zIl0sImVudiI6eyJOR19QT1NUQ09ERV9BUElfS0VZIjoiJHtOR19QT1NUQ09ERV9BUElfS0VZfSIsIk5HX1BPU1RDT0RFX01BWF9MRVZFTCI6IjEiLCJOR19QT1NUQ09ERV9NQVhfUEFJRF9DQUxMUyI6IjI1IiwiTkdfUE9TVENPREVfQkFTRV9VUkwiOiJodHRwczovL2FwaS5wb3N0Y29kZS5nb3YubmciLCJOR19QT1NUQ09ERV9UUkFOU1BPUlQiOiJzdGRpbyIsIk5HX1BPU1RDT0RFX0hPU1QiOiIxMjcuMC4wLjEiLCJOR19QT1NUQ09ERV9QT1JUIjoiODAwMCJ9fQ%3D%3D"
}{
"servers": {
"ng-postcode": {
"type": "stdio",
"command": "uvx",
"args": [
"ng-postcode-mcp==0.6.3"
],
"env": {
"NG_POSTCODE_API_KEY": "${NG_POSTCODE_API_KEY}",
"NG_POSTCODE_MAX_LEVEL": "1",
"NG_POSTCODE_MAX_PAID_CALLS": "25",
"NG_POSTCODE_BASE_URL": "https://api.postcode.gov.ng",
"NG_POSTCODE_TRANSPORT": "stdio",
"NG_POSTCODE_HOST": "127.0.0.1",
"NG_POSTCODE_PORT": "8000"
}
}
}
}{
"mcpServers": {
"ng-postcode": {
"command": "uvx",
"args": [
"ng-postcode-mcp==0.6.3"
],
"env": {
"NG_POSTCODE_API_KEY": "${NG_POSTCODE_API_KEY}",
"NG_POSTCODE_MAX_LEVEL": "1",
"NG_POSTCODE_MAX_PAID_CALLS": "25",
"NG_POSTCODE_BASE_URL": "https://api.postcode.gov.ng",
"NG_POSTCODE_TRANSPORT": "stdio",
"NG_POSTCODE_HOST": "127.0.0.1",
"NG_POSTCODE_PORT": "8000"
}
}
}
}extensions:
"ng-postcode":
enabled: true
name: "ng-postcode"
type: stdio
cmd: "uvx"
args:
- "ng-postcode-mcp==0.6.3"
envs:
"NG_POSTCODE_API_KEY": "${NG_POSTCODE_API_KEY}"
"NG_POSTCODE_MAX_LEVEL": "1"
"NG_POSTCODE_MAX_PAID_CALLS": "25"
"NG_POSTCODE_BASE_URL": "https://api.postcode.gov.ng"
"NG_POSTCODE_TRANSPORT": "stdio"
"NG_POSTCODE_HOST": "127.0.0.1"
"NG_POSTCODE_PORT": "8000"
timeout: 300
Placeholders to fill from your own secret store: ${NG_POSTCODE_API_KEY}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected], [email protected]No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo ~liveness-unmeasured +updated-3d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
[email protected] PyPIthis version is not known to the dependency resolver
[email protected] npmthis version is not known to the dependency resolver
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
ng-postcode-mcp | pypi | 0.6.3 | uvx | NG_POSTCODE_API_KEY |
ng-postcode-mcp | npm | 0.4.2 | npx | NG_POSTCODE_API_KEY |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.Adeniyikayodee/ng-postcode",
"title": "Nigeria Postcode",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.6.3",
"packages": [
{
"version": "0.6.3",
"transport": {
"type": "stdio"
},
"identifier": "ng-postcode-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"environmentVariables": [
{
"name": "NG_POSTCODE_API_KEY",
"isSecret": true,
"description": "NIPOST Postcode API key from dashboard.postcode.gov.ng. Validation works without it."
},
{
"name": "NG_POSTCODE_MAX_LEVEL",
"choices": [
"1",
"2",
"3",
"4",
"5"
],
"default": "1",
"description": "Highest lookup level tools may request. Levels 2 and up consume NIPOST credits."
},
{
"name": "NG_POSTCODE_MAX_PAID_CALLS",
"default": "25",
"description": "How many paid lookups one run of the server may make with its own key."
},
{
"name": "NG_POSTCODE_BASE_URL",
"default": "https://api.postcode.gov.ng",
"description": "Alternative API host, such as a staging stack."
},
{
"name": "NG_GEOCODER_URL",
"description": "Nominatim server used by resolve_address to place described addresses. Ideally your own instance."
},
{
"name": "NG_GEOCODER_CONTACT",
"description": "URL or email identifying you to the geocoder. Required for the public Nominatim."
},
{
"name": "NG_POSTCODE_TRANSPORT",
"choices": [
"stdio",
"http"
],
"default": "stdio",
"description": "stdio (default), or http to serve streamable HTTP at /mcp on NG_POSTCODE_HOST and NG_POSTCODE_PORT."
},
{
"name": "NG_POSTCODE_HOST",
"default": "127.0.0.1",
"description": "Address the HTTP transport listens on."
},
{
"name": "NG_POSTCODE_PORT",
"default": "8000",
"description": "Port the HTTP transport listens on."
},
{
"name": "NG_POSTCODE_ALLOW_SHARED_KEY",
"choices": [
"1"
],
"description": "Set to 1 to let the HTTP transport start with a server key on a public address."
},
{
"name": "NG_POSTCODE_ALLOWED_HOSTS",
"description": "Host names the HTTP transport answers to, separated by commas. Required with a server key on a public address."
}
]
},
{
"version": "0.4.2",
"transport": {
"type": "stdio"
},
"identifier": "ng-postcode-mcp",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "NG_POSTCODE_API_KEY",
"isSecret": true,
"description": "NIPOST Postcode API key from dashboard.postcode.gov.ng. Validation works without it."
},
{
"name": "NG_POSTCODE_MAX_LEVEL",
"choices": [
"1",
"2",
"3",
"4",
"5"
],
"default": "1",
"description": "Highest lookup level tools may request. Levels 2 and up consume NIPOST credits."
},
{
"name": "NG_POSTCODE_MAX_PAID_CALLS",
"default": "25",
"description": "How many paid lookups one run of the server may make with its own key."
},
{
"name": "NG_POSTCODE_BASE_URL",
"default": "https://api.postcode.gov.ng",
"description": "Alternative API host, such as a staging stack."
}
]
}
],
"repository": {
"url": "https://github.com/Adeniyikayodee/ng-postcode",
"source": "github",
"subfolder": "mcp"
},
"description": "Validate, look up and resolve addresses to Nigeria's NIPOST digital postcodes (NDAPS)."
}