nigerian-reference-data
Nigerian phone, bank-account and identity-number validation for AI agents. Pay-per-call in USDC.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"nigerian-reference-data": {
"url": "https://api.postandshare.net/mcp"
}
}
}Remote endpoints
https://api.postandshare.net/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢ng_states
List all 36 Nigerian states plus the Federal Capital Territory with their capitals. Free — no payment required.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪ng_phone_lookup(number)
$0.003 per call. Normalise a Nigerian phone number (local, +234 or 234 form) and return E.164, line type and network from the prefix allocation. Pay-per-call in USDC over x402.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "Nigerian number, e.g. 08031234567"
}
},
"required": [
"number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢ng_bank_validate(bank_code, account_number)
$0.003 per call. Validate a 10-digit NUBAN account number against its 3-digit CBN bank code using the check-digit algorithm. Format validation only — does not confirm the account exists.
Input Schema
{
"type": "object",
"properties": {
"bank_code": {
"type": "string",
"description": "3-digit CBN bank code, e.g. 058 for GTBank"
},
"account_number": {
"type": "string",
"description": "10-digit NUBAN account number"
}
},
"required": [
"bank_code",
"account_number"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪ng_identity_format(type, value)
$0.002 per call. Format-validate a Nigerian NIN, BVN, TIN, CAC RC or CAC BN number. Returns validity only — no database lookup and no personal data.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"NIN",
"BVN",
"TIN",
"CAC_RC",
"CAC_BN"
],
"description": "Which number type"
},
"value": {
"type": "string",
"description": "The number to check"
}
},
"required": [
"type",
"value"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢chain_networks
List the chains this API can read: Base, Ethereum, Arbitrum One, Polygon, with chain ids. Free — no payment required.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chain_block_number(network)
$0.001 per call. The latest block number on Base, Ethereum, Arbitrum One or Polygon. Pay-per-call in USDC over x402.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"base",
"ethereum",
"arbitrum",
"polygon"
],
"description": "Chain to read (default base)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chain_balance(address, network)
$0.001 per call. Native-token (ETH/POL) balance of an EVM address, with a USD value at the current spot price.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "0x-prefixed EVM address"
},
"network": {
"type": "string",
"enum": [
"base",
"ethereum",
"arbitrum",
"polygon"
],
"description": "Chain to read (default base)"
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chain_gas(network)
$0.001 per call. Current gas price on a chain plus the cost of a plain native transfer, in native token and USD.
Input Schema
{
"type": "object",
"properties": {
"network": {
"type": "string",
"enum": [
"base",
"ethereum",
"arbitrum",
"polygon"
],
"description": "Chain to read (default base)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chain_block(number, network)
$0.001 per call. Block header by number or latest: timestamp, transaction count, gas used, base fee.
Input Schema
{
"type": "object",
"properties": {
"number": {
"type": "string",
"description": "Block number, or \"latest\" (default)"
},
"network": {
"type": "string",
"enum": [
"base",
"ethereum",
"arbitrum",
"polygon"
],
"description": "Chain to read (default base)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chain_tx(hash, network)
$0.001 per call. Transaction receipt by hash: success/failed status, block, gas used, and the fee in native token and USD.
Input Schema
{
"type": "object",
"properties": {
"hash": {
"type": "string",
"description": "0x-prefixed transaction hash"
},
"network": {
"type": "string",
"enum": [
"base",
"ethereum",
"arbitrum",
"polygon"
],
"description": "Chain to read (default base)"
}
},
"required": [
"hash"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪chain_token(token, holder, network)
$0.001 per call. ERC-20 token metadata (symbol, name, decimals) and one holder's balance.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string",
"description": "0x-prefixed ERC-20 contract address"
},
"holder": {
"type": "string",
"description": "0x-prefixed wallet address"
},
"network": {
"type": "string",
"enum": [
"base",
"ethereum",
"arbitrum",
"polygon"
],
"description": "Chain to read (default base)"
}
},
"required": [
"token",
"holder"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence