Malaysia Invoices (LHDN MyInvois submit, query & cancel)

Official4 toolsLive

by junter1989k-ai · JavaScript

Malaysia LHDN MyInvois: AI agents submit, query and cancel e-invoices, stateless BYO.

Topics

ai-agentclaudee-invoiceinvoicemalaysiamcpmcp-servermyinvoistaxvatwishpool

Captured live from the server via tools/list.

submit_invoice

Submit an ALREADY-SIGNED Malaysian e-invoice (UBL 2.1) to LHDN MyInvois — the POST /api/v1.0/documentsubmissions call. This server does NOT sign: you XAdES-sign the UBL document merchant-side, compute its SHA-256 hash, and pass { format, document(base64), documentHash, codeNumber }. MyInvois validates asynchronously, so a successful submit returns a submissionUid plus accepted_documents (each with the assigned uuid) and rejected_documents — it does NOT yet mean the invoice is Valid; call query_submission with the submissionUid to poll the validation outcome. Result: accepted=true when at least one document was accepted for processing (HTTP 202); rejected_documents lists any structurally-rejected documents with their error. Required credential headers (set once in your MCP client, per-request, never stored): x-myinvois-client-id + x-myinvois-client-secret (your ERP OAuth2 credentials from the MyTax "Register ERP" self-service). Optional header x-myinvois-mode: sandbox (default = preprod, no fiscal effect) | prod (production, real fiscal effect). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.

Parameters4

document	string	required	The FULL signed UBL 2.1 document, base64-encoded. You XAdES-sign it merchant-side; this server forwards the bytes untouched.
documentHash	string	required	SHA-256 hash (hex) of the signed document bytes. Computed merchant-side; MyInvois re-checks it against the document.
codeNumber	string	required	Your internal invoice number / eInvoice code number (cbc:ID of the document), e.g. INV-2026-000123. Used to correlate accepted/rejected results.
format	string	optional	Document format: JSON (default) or XML — must match how you built and signed the document.

Raw schema

{
  "type": "object",
  "properties": {
    "document": {
      "type": "string",
      "description": "The FULL signed UBL 2.1 document, base64-encoded. You XAdES-sign it merchant-side; this server forwards the bytes untouched."
    },
    "documentHash": {
      "type": "string",
      "description": "SHA-256 hash (hex) of the signed document bytes. Computed merchant-side; MyInvois re-checks it against the document."
    },
    "codeNumber": {
      "type": "string",
      "description": "Your internal invoice number / eInvoice code number (cbc:ID of the document), e.g. INV-2026-000123. Used to correlate accepted/rejected results."
    },
    "format": {
      "type": "string",
      "enum": [
        "JSON",
        "XML"
      ],
      "description": "Document format: JSON (default) or XML — must match how you built and signed the document."
    }
  },
  "required": [
    "document",
    "documentHash",
    "codeNumber"
  ]
}

query_submission

Get the validation status of a MyInvois submission — the GET /api/v1.0/documentsubmissions/{submissionUid} call. Use the submissionUid returned by submit_invoice to poll (MyInvois validates asynchronously; 3-5s polling is recommended). Result overall_status enum: "in progress" (still validating), "valid" (all documents valid), "partially valid" (some valid, some invalid), "invalid" (all invalid). document_summary lists each document with its own status (Submitted / Valid / Invalid / Cancelled), uuid and totals. Required credential headers (set once in your MCP client, per-request, never stored): x-myinvois-client-id + x-myinvois-client-secret (your ERP OAuth2 credentials from the MyTax "Register ERP" self-service). Optional header x-myinvois-mode: sandbox (default = preprod, no fiscal effect) | prod (production, real fiscal effect). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.

Parameters3

submissionUid	string	required	The submissionUid returned by submit_invoice (26 alphanumeric characters).
pageNo	number	optional	Optional page number when the submission has many documents.
pageSize	number	optional	Optional documents per page (max 100).

Raw schema

{
  "type": "object",
  "properties": {
    "submissionUid": {
      "type": "string",
      "description": "The submissionUid returned by submit_invoice (26 alphanumeric characters)."
    },
    "pageNo": {
      "type": "number",
      "description": "Optional page number when the submission has many documents."
    },
    "pageSize": {
      "type": "number",
      "description": "Optional documents per page (max 100)."
    }
  },
  "required": [
    "submissionUid"
  ]
}

cancel_invoice

Cancel a previously-issued, VALID MyInvois document — the PUT /api/v1.0/documents/state/{uuid}/state call (body status=cancelled). Only allowed within the 72-HOUR window from the moment the document became valid; after that you must issue a credit/debit note instead. In: uuid (the document uuid from query_submission, NOT the submissionUid) + reason (why, max 300 chars). Result status "Cancelled" on success. Common errors: OperationPeriodOver (72h passed), IncorrectState (not cancellable), ActiveReferencingDocuments (referenced by another doc), Forbidden (you did not issue it). Required credential headers (set once in your MCP client, per-request, never stored): x-myinvois-client-id + x-myinvois-client-secret (your ERP OAuth2 credentials from the MyTax "Register ERP" self-service). Optional header x-myinvois-mode: sandbox (default = preprod, no fiscal effect) | prod (production, real fiscal effect). Optional owner-policy headers x-agentpay-max-amount / x-agentpay-approval-above / x-agentpay-allowed-tools.

Parameters2

uuid	string	required	The MyInvois document uuid to cancel (26 alphanumeric characters, from query_submission — NOT the submissionUid).
reason	string	required	Reason for cancellation (mandatory, max 300 characters).

Raw schema

{
  "type": "object",
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The MyInvois document uuid to cancel (26 alphanumeric characters, from query_submission — NOT the submissionUid)."
    },
    "reason": {
      "type": "string",
      "description": "Reason for cancellation (mandatory, max 300 characters)."
    }
  },
  "required": [
    "uuid",
    "reason"
  ]
}

build_invoice_draft

Local helper (NO network, NO credentials, NO signing): assemble an UNSIGNED UBL 2.1 invoice skeleton from line items and Malaysian SST tax, and compute the monetary totals (excl-tax, tax, incl-tax, payable). Use it to prepare a document you then complete (supplier/buyer TIN, MSIC code, etc.), XAdES-sign, hash, and pass to submit_invoice. It does NOT submit and has NO fiscal effect. In: lines [{ description, quantity, unitPrice, taxRate? (percent, e.g. 0/6/8/10) }], codeNumber, currency? (default MYR), issueDate? (default today). Out: computed totals + ubl_json skeleton. NOTE: it applies the taxRate you give per line (SST classification is your decision); it does not pick the rate for you.

Parameters4

lines	array	required	Line items. Each: { description, quantity, unitPrice, taxRate? }. taxRate is a percentage (0 = exempt/zero-rated; 6/8 = service tax; 5/10 = sales tax).
codeNumber	string	required	Your internal invoice number / eInvoice code number (becomes the document cbc:ID).
currency	string	optional	ISO currency code, default MYR.
issueDate	string	optional	Issue date YYYY-MM-DD, default today (UTC).

Raw schema

{
  "type": "object",
  "properties": {
    "lines": {
      "type": "array",
      "description": "Line items. Each: { description, quantity, unitPrice, taxRate? }. taxRate is a percentage (0 = exempt/zero-rated; 6/8 = service tax; 5/10 = sales tax).",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "quantity": {
            "type": "number"
          },
          "unitPrice": {
            "type": "number"
          },
          "taxRate": {
            "type": "number"
          }
        },
        "required": [
          "description",
          "quantity",
          "unitPrice"
        ]
      }
    },
    "codeNumber": {
      "type": "string",
      "description": "Your internal invoice number / eInvoice code number (becomes the document cbc:ID)."
    },
    "currency": {
      "type": "string",
      "description": "ISO currency code, default MYR."
    },
    "issueDate": {
      "type": "string",
      "description": "Issue date YYYY-MM-DD, default today (UTC)."
    }
  },
  "required": [
    "lines",
    "codeNumber"
  ]
}

Install

Tools (4)

submit_invoicequery_submissioncancel_invoicebuild_invoice_draft

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://inv-my.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "malaysia-invoice-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://inv-my.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.