🇳🇬 Nigeria Invoice MCP live

AI agents can now issue Nigeria e-invoices — a signed IRN from FIRS / NRS MBS (the Merchant Buyer Solution). This remote MCP server wraps the FIRS NRS MBS e-invoicing API with three tools: validate_invoice, create_invoice, query_invoice. FIRS signs server-side and returns the IRN, CSID and QR code.

Connect

{
  "mcpServers": {
    "nigeria-invoice": {
      "type": "http",
      "url": "https://inv-ng.wishpool.app/mcp",
      "headers": {
        "x-firs-api-key": "your-key",
        "x-firs-api-secret": "your-secret"
      }
    }
  }
}

Generate your API key and secret in your NRSMBS Dashboard → API Integration. Your business must first be enabled for e-invoicing on the NRS Merchant Buyer Solution. If your Dashboard issued a sandbox base URL, also send header x-firs-base-url (defaults to production https://api.firsmbs.com/api/v1).

The IRN & UBL flow

Send flat fields; the server builds the UBL-mapped JSON and computes the tax. The IRN is InvoiceNumber-ServiceID-YYYYMMDD (e.g. ITW20853450-6997D6BB-20240703) — pass irn directly or let the server build it from invoice_number + service_id + issue_date. VAT is applied at Nigeria's 7.5% standard rate (override per line with vat_rate) into tax_total and legal_monetary_total.

Why it is safe

• Stateless: no database — credentials travel per-request in headers and are never stored.
• Signing stays upstream: FIRS / NRS MBS validates and signs the invoice server-side; we only translate MCP calls and compute the UBL tax schema.
• Owner policy guardrails: x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools — set by the human owner in client config; the agent cannot relax them. The cap/threshold applies to the invoice total (NGN).

Honest status

Each merchant enables e-invoicing and generates their own API key in the NRSMBS Dashboard; this server is a pure forwarder (in-house / OEM path, not an APP/SI accreditation intermediary). The sandbox base URL is self-served from your Dashboard. This build is validated against the official FIRS MBS API surface and forwards correctly (fake-key probes reach the live gateway); the first real merchant with live credentials completes the end-to-end signing verification.

Sister servers

Mexico CFDI 4.0 (inv-mx.wishpool.app) and India GST e-invoices / IRN (inv-in.wishpool.app) are live. Local payments in 81 countries — one family, same stateless pattern: mcp.wishpool.app. Taiwan e-invoice (電子發票) included. More invoice countries coming: Brazil NF-e, Chile DTE, Poland KSeF, Romania e-Factura, Italy SdI.