Nigeria Invoices (FIRS / NRS MBS e-invoicing IRN) MCP server

Sign and submit a Nigeria e-invoice to FIRS / NRS MBS — POST /invoice/sign. FIRS signs it server-side and returns the official IRN (Invoice Reference Number), CSID (Cryptographic Stamp Identifier) and QR code to print on the invoice. Bring your own credentials via headers x-firs-api-key AND x-firs-api-secret. The IRN format is InvoiceNumber-ServiceID-YYYYMMDD (e.g. ITW20853450-6997D6BB-20240703): pass irn directly if you already have it, otherwise this server builds it from invoice_number + service_id + issue_date. You send flat fields; the server builds the UBL-mapped JSON and computes VAT (7.5% Nigeria standard rate by default; override per line with vat_rate) into tax_total and legal_monetary_total. Recommended: call validate_invoice first.

Pre-validate a Nigeria e-invoice against FIRS / NRS MBS (Merchant Buyer Solution) BEFORE signing — POST /invoice/validate. Returns pass, or the FIRS error list if the payload is rejected (so you fix it before spending a real submission). Bring your own credentials via headers x-firs-api-key AND x-firs-api-secret (generate them in your NRSMBS Dashboard -> API Integration; your business must be enabled for e-invoicing first). If your Dashboard issued a sandbox base URL, also send header x-firs-base-url. You send flat fields (business_id, supplier/customer party name + TIN, invoice_number, service_id, line items with price); this server builds the UBL-mapped JSON and computes VAT (7.5% default) into tax_total and legal_monetary_total. No fiscal effect — nothing is signed.

Look up a signed Nigeria e-invoice by its IRN at FIRS / NRS MBS — GET /invoice/confirm/{irn}. Returns the transmission / delivery status and the IRN/CSID. Safe to call anytime.