app.wishpool/india-invoice-mcp (MCP)

This MCP server provides India GST e-invoicing for AI agents. It can generate, query, and cancel IRNs at the IRP via a GSP. The service is described as stateless, with credentials sent as HTTP headers per request rather than stored.

🛠️ Key Features

Generate GST e-invoices and IRNs for India
Query IRNs
Cancel IRNs at the IRP via a GSP
Stateless operation
Credentials sent as HTTP headers on each request (not stored)

🚀 Use Cases

Enable an AI agent to create GST e-invoices in India
Retrieve information by IRN using an agent workflow
Request IRN cancellation through an agent integration

⚡ Developer Benefits

MCP-compatible HTTP server endpoint: https://inv-in.wishpool.app/mcp
Works with MCP clients (e.g., Claude Desktop, Cursor, Windsurf, or any MCP-capable agent)
No local installation; configuration via MCP client settings

⚠️ Limitations

Credentials are required via per-request HTTP headers (no stored credentials)
The provided excerpt does not include details beyond generate/query/cancel and stateless behavior

India Invoice MCP 🇮🇳 — How can my AI agent generate a GST e-invoice (IRN) in India?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "india-invoice": {
      "type": "http",
      "url": "https://inv-in.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/india-invoice-mcp && cd india-invoice-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent generate India GST e-invoices — registering an invoice with the IRP (Invoice Registration Portal, run by GSTN) to get an IRN (Invoice Reference Number) plus the signed QR code — through the Sandbox.co.in GSP (GST Suvidha Provider). Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-in.wishpool.app/mcp · Registry: app.wishpool/india-invoice-mcp

Quick start

json

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

Sign up at sandbox.co.in for GSP credentials. Your GSTIN must have GST e-Invoice API access enabled on the e-Invoice portal and mapped to Sandbox as your GSP — otherwise the IRP rejects the stamp. e-Invoicing is B2B only: both seller and buyer need valid GSTINs.

Tools

Tool	What it does
`create_invoice`	Register a GST e-invoice at the IRP and get the `irn` (+ `AckNo`, `AckDt`, `SignedQRCode`). You send flat fields (GSTINs, names, addresses, line items with HSN + price + gst_rate); the server auto-computes the INV-01 tax schema — taxable value, CGST+SGST split for same-state supply vs IGST for cross-state, item + invoice totals.
`query_invoice`	Status check by IRN: `ACT` (active) or `CNL` (cancelled).
`cancel_invoice`	Cancel at the IRP with a reason code (`1`–`4`, default `4`) — only within 24 hours of generation; after that, issue a credit note.

Owner policy guardrails ride optional headers (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 amount cap/threshold applies to the invoice total (INR).

GST tax split (computed for you)

The place of supply (POS) state code is compared with the seller GSTIN's state code:

Same state → intra-state supply → CGST + SGST, each at half the GST rate.
Different state → inter-state supply → IGST at the full GST rate.

Example: seller in state 29, buyer in state 29, one line of ₹1000 × 2 @ 18% → AssVal ₹2000, CGST ₹180 + SGST ₹180, TotInvVal ₹2360. Same line to a buyer in state 27 → IGST ₹360, TotInvVal ₹2360.

Develop

bash

node test/serve.js   # local server on :3230
node test/e2e.js     # protocol + validation + GST math unit check + fake-key live probe

Safety

Pure stateless translation layer. The IRP/GSTN certification burden sits with the Sandbox.co.in GSP; credentials travel per-request in headers, nothing is stored. Privacy policy.

Sister servers

Mexico CFDI 4.0 e-invoices are live: inv-mx.wishpool.app. Local payments in 81 countries, one family: mcp.wishpool.app · Taiwan e-invoice 電子發票 included. More invoice countries coming: Brazil NF-e · Chile DTE · Peru CPE · Poland KSeF · Romania e-Factura · Italy SdI.

MIT licensed.

seller_gstin	string	required	Seller (supplier) 15-char GSTIN, e.g. 29ABCDE1234F1Z5. Its first 2 digits are the seller state code and drive the CGST+SGST vs IGST decision.
seller_legal_name	string	required	Seller legal name (LglNm) exactly as registered under this GSTIN.
seller_address	string	required	Seller registered address line 1 (Addr1).
seller_city	string	required	Seller city / location (Loc).
seller_pincode	string	required	Seller 6-digit PIN code (Pin).
buyer_gstin	string	required	Buyer (recipient) 15-char GSTIN. Required — e-invoicing is B2B only.
buyer_legal_name	string	required	Buyer legal name (LglNm) as registered under the buyer GSTIN.
buyer_address	string	required	Buyer address line 1 (Addr1).
buyer_city	string	required	Buyer city / location (Loc).
buyer_pincode	string	required	Buyer 6-digit PIN code (Pin).
buyer_state_code	string	optional	Optional place-of-supply state code (POS), 2 digits. Defaults to the buyer GSTIN state code. Set this if the place of supply differs from the buyer registration state.
doc_number	string	required	Your invoice/document number (DocDtls.No), max 16 chars.
doc_date	string	optional	Invoice date DD/MM/YYYY (DocDtls.Dt). Defaults to today (UTC).
items	array	required	Line items. Each: description, hsn_code (HSN/SAC), price (unit price in INR, tax-EXCLUSIVE), gst_rate (percent, e.g. 18), optional quantity (default 1) and unit (default NOS). GST is computed on top of price*quantity.

irn	string	required	The IRN returned by create_invoice.
reason_code	string	optional	NIC cancellation reason: 1 Duplicate, 2 Data entry mistake, 3 Order cancelled, 4 Others. Default 4.
remarks	string	optional	Free-text remarks explaining the cancellation (required by the IRP), max 100 chars.

India Invoices (GST e-invoicing IRN via IRP)

app.wishpool/india-invoice-mcp (MCP)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_invoice

query_invoice

cancel_invoice