Saudi Vat Pro MCP server

Read from the package source without running it. The installed server may list more.

• create_credit_notewrite action

  Issue a ZATCA credit note (document type 381) against a cleared or reported invoice. Omit lines for the remaining full refundable balance, or provide positive partial-refund lines that do not exceed the parent's remaining quantities and amounts. Supply a stable idempotencyKey so agent/network retries cannot create a duplicate credit note.

• create_invoicewrite action

  Create a Saudi e-invoice and run the available ZATCA pipeline. Before calling, use get_zatca_status and confirm environment='production' for a legally submitted invoice; sandbox submissions are tests only. Standard (B2B) invoices require buyerName, buyerVatNumber, and buyerCity and normally clear; simplified invoices normally report. Always inspect the returned status: cleared/reported means submi

• explain_invoice_error

  Get an AI-generated plain-language explanation of why an invoice failed ZATCA validation, along with specific suggested actions to fix it. Most useful for 'failed' or 'needs_data' invoices.

• get_dashboard_summary

  Get a compliance health summary: total invoices, counts by status (cleared, failed, pending), VAT totals for the current period, and any outstanding issues requiring attention.

• get_invoice

  Get full invoice detail including line items, ZATCA submission status, error messages, QR code, and the event timeline showing every step of the compliance pipeline.

• get_merchant_profile

  Get the merchant's business profile including business name, VAT number, address, default invoice settings, and subscription plan.

• get_zatca_status

  Check certificate (CSID) enrollment, expiry, environment, and readiness before creating invoices. environment='sandbox' is test-only and does not constitute legal ZATCA submission; confirm environment='production' for live invoices.

• list_invoices

  List ZATCA invoices with optional filters. Returns paginated invoice summaries including status, totals, and ZATCA submission results.

• retry_invoice

  Re-run the ZATCA compliance pipeline for a failed invoice after correcting it in the Saudi VAT Pro dashboard. Returns the updated status; always inspect it rather than assuming submission succeeded.

• Code scan4 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 13 days ago15/15
• Maintainer identityregistry namespace matches repository owner6/10

Saudi Vat Pro: common questions

Is Saudi Vat Pro MCP server safe?

Mostly: it is graded B (80/100). Read the Saudi Vat Pro safety report

How do I install Saudi Vat Pro?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Saudi Vat Pro need an API key?

Yes. The registry entry asks for SAUDI_VAT_PRO_API_KEY.

Is Saudi Vat Pro maintained?

The last commit was 13 days ago (2026-09-07). The latest release is v1.0.1.