Nigeria MCP — Nigerian data for AI agents

A Braynex Services Ltd product. Author: Samuel Orie. License: MIT.

Clean, normalized Nigerian business & local data exposed to AI agents (Claude, Cursor, custom agents) as MCP tools — one server per data source, each behind a typed provider seam.

Status: 4 servers LIVE on npm + the official MCP Registry. Every server runs offline on a mock provider with zero signup; live data is one env var.

Products

• Trade Intel — Nigeria import/export statistics by partner, commodity and year, annual or monthly, with USD value (plus CIF/FOB), net weight and quantity, and commodity breakdowns. Plus HS-code classification.

• FX Rates — live Naira rates against USD, EUR and GBP.

• Bank Resolve — resolve a 10-digit NUBAN + bank code to the registered account name; list banks with their codes.

• Electricity Meter — read-only meter validation (customer name/address + DisCo) and the DisCo list. No payments.

Each server's README has full tool docs, examples and a copy-paste config: see lanes/<server>/README.md. Real-world applications: USE_CASES.md.

Related MCP server: mcp-brasil

Install — Claude Desktop / Code

No clone needed (Node.js ≥ 20). Add to your MCP config:

{
  "mcpServers": {
    "nigeria-trade-intel": {
      "command": "npx",
      "args": ["-y", "@braynexservices/nigeria-mcp-trade-intel"],
      "env": { "TRADE_PROVIDER": "opendata" }      // live data, no key
    },
    "nigeria-fx-rates": {
      "command": "npx",
      "args": ["-y", "@braynexservices/nigeria-mcp-fx-rates"],
      "env": { "FX_PROVIDER": "free" }             // live data, no key
    }
  }
}

Then ask: "What were Nigeria's top crude-oil export partners in 2023?" or "What's the dollar to naira rate right now?"

The keyed servers take their credentials the same way — see lanes/bank-account/README.md (free Paystack key) and lanes/electricity/README.md (free VTpass keys). Omit the env block entirely and every server runs on offline mock data.

MCP Registry

Listed on the official registry as:

io.github.Braynexservices/nigeria-trade-intel
io.github.Braynexservices/nigeria-fx-rates
io.github.Braynexservices/nigeria-bank-resolve
io.github.Braynexservices/nigeria-electricity

Build from source

npm install
npm run build      # core first, then each server (npm workspaces)
npm run verify     # build + smokes + cross-server eval — fully offline, zero signup

How it works

Tools never call a provider directly: they depend on a typed interface, so selecting a provider is one env var and adding one is one file. Identity data (account names, meter customer details) is pass-through only — never cached, never logged; API keys travel in headers, never in URLs.

Security

Report vulnerabilities privately — see SECURITY.md. Do not open a public issue.

© 2026 Braynex Services Ltd — MIT licensed (see LICENSE + NOTICE). "Braynex Services Ltd" and the product names are trademarks of Braynex Services Ltd.