Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Nigerian Reference Data

БесплатноПоддерживается

MCP server: pay-per-call Nigerian validation and reference data for AI agents (x402, USDC, no API keys).

GitHubEmbed

Описание

MCP server: pay-per-call Nigerian validation and reference data for AI agents (x402, USDC, no API keys).

README

An MCP server that gives AI agents pay-per-call Nigerian reference data and validation — no API key, no account, no signup. Each paid call settles in USDC over x402 on Base or Polygon, so an agent can buy exactly what it needs, one call at a time.

Built for agents doing Nigerian onboarding, form validation, routing and fraud screening — the checks they currently cannot do, because the data is local.

Install

Add to any MCP host (Claude Desktop, Cursor, Hermes, and anything else speaking MCP):

{
  "mcpServers": {
    "nigerian-reference-data": {
      "command": "npx",
      "args": ["-y", "nigerian-reference-data-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_WALLET_KEY" }
    }
  }
}

X402_PRIVATE_KEY is optional. Set it and the server pays each x402 challenge automatically from that wallet (which needs USDC on Base or Polygon — the facilitator covers the gas, so no native token is required). Leave it out and paid tools return the live payment challenge instead of data, so your host can settle it however it likes. The free tool works either way.

If your wallet holds USDC on a chain other than Base, set X402_PREFER_NETWORKS to the chain you want to pay on, e.g. eip155:137 for Polygon. Without it the server pays on Base.

Tools

Tool Price What it does
ng_phone_lookup $0.003 Normalise a Nigerian number (local, +234, 234…), return E.164, line type, and network from the prefix allocation
ng_bank_validate $0.003 Validate a 10-digit NUBAN account number against its 3-digit CBN bank code (check-digit algorithm)
ng_identity_format $0.002 Format-check a NIN, BVN, TIN, CAC RC or CAC BN number
ng_states free All 36 states plus the FCT, with capitals

Example — ask your agent: "Is 08031234567 a valid Nigerian number, and which network is it on?"

What it deliberately does not do

Format and reference validation only. No personal data is returned, no identity database is queried, and no account is confirmed to exist. Real NIN/BVN verification requires a NIMC-licensed partner and is a separate thing entirely.

HTTP API

The same endpoints are available directly over HTTP if you'd rather not use MCP:

  • GET /v1/ng/phone/lookup?number=08031234567 — $0.003
  • GET /v1/ng/bank/validate?bank_code=058&account_number=0123456789 — $0.003
  • GET /v1/ng/identity/format?type=NIN&value=12345678901 — $0.002
  • GET /v1/ng/states — free

An unpaid call returns 402 Payment Required with machine-readable terms in the PAYMENT-REQUIRED header. Manifest: /llms.txt, OpenAPI: /openapi.json.

Licence

MIT.

from github.com/chimaobikanu/nigerian-reference-data-mcp

Установить Nigerian Reference Data в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE
unyly install nigerian-reference-data

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add nigerian-reference-data --env X402_PRIVATE_KEY="" -- npx -y nigerian-reference-data-mcp

Пошаговые гайды: как установить Nigerian Reference Data

FAQ

Nigerian Reference Data MCP бесплатный?

Да, Nigerian Reference Data MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Nigerian Reference Data?

Да, требуются переменные окружения: X402_PRIVATE_KEY. Unyly подставит их в конфиг при установке.

Nigerian Reference Data — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Nigerian Reference Data в Claude Desktop, Claude Code или Cursor?

Открой Nigerian Reference Data на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions
83

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare Nigerian Reference Data with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai