# India Invoice MCP

> A remote MCP server that lets any AI agent generate India GST e-invoices — registering an invoice at the IRP (Invoice Registration Portal, GSTN) to obtain an IRN (Invoice Reference Number) and signed QR code — through the Sandbox.co.in GSP (GST Suvidha Provider). Create, query and cancel e-invoices. Stateless, bring-your-own credentials, never stores anything.

- MCP endpoint (Streamable HTTP): https://inv-in.wishpool.app/mcp
- Credentials headers: x-sandbox-api-key AND x-sandbox-api-secret (your Sandbox.co.in GSP credentials; sign up at sandbox.co.in). Your GSTIN must have GST e-Invoice API access enabled on the e-Invoice portal and mapped to Sandbox as your GSP.
- e-Invoicing is B2B only: both seller and buyer must have valid 15-character GSTINs.
- Flow: create_invoice (returns Irn = IRN, AckNo, AckDt, SignedQRCode) -> query_invoice by irn to re-check status (ACT / CNL) -> cancel_invoice within 24h if wrong (after 24h issue a credit note).
- Amounts in INR. The server auto-computes the GST INV-01 tax schema: per-item taxable value, CGST+SGST for same-state supply vs IGST for cross-state (decided from seller GSTIN state vs place-of-supply state), item totals, AssVal and TotInvVal.

## Tools

- create_invoice: Register a GST e-invoice at the IRP — flat fields (seller/buyer GSTIN + name + address, doc_number, line items with hsn_code, price, quantity, gst_rate) in; Irn (IRN), AckNo, AckDt, SignedQRCode out. Tax split (CGST/SGST vs IGST) and totals computed automatically.
- query_invoice: Check e-invoice status by IRN — ACT (active) or CNL (cancelled).
- cancel_invoice: Cancel an IRN at the IRP with a reason code (1 Duplicate, 2 Data entry mistake, 3 Order cancelled, 4 Others; default 4) — allowed only within 24h of generation.
- Owner policy guardrails: x-agentpay-max-amount (hard cap on invoice total in INR), x-agentpay-approval-above (returns an unsigned draft for human review), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them.

## Safety

Stateless translation layer. The IRP/GSTN certification burden sits with the Sandbox.co.in GSP; the merchant's e-Invoice API credentials and GSTIN mapping stay in the merchant's own Sandbox account. This server never stores credentials, invoices, or customer data. Privacy policy: https://inv-in.wishpool.app/privacy

## Sister servers

Same stateless BYO pattern. Mexico CFDI 4.0 e-invoices are live: https://inv-mx.wishpool.app/mcp. Local payments in 81 countries — full list: https://mcp.wishpool.app/llms.txt (Taiwan e-invoice 電子發票 lives in https://mcp.wishpool.app/mcp). More invoice countries coming: Brazil NF-e, Chile DTE, Peru CPE, Poland KSeF, Romania e-Factura, Italy SdI.