Saudi Vat Pro MCP server

by Morouna1·io.github.Morouna1/saudi-vat-pro·v1.0.1

No reviews yet

Submit and manage ZATCA-compliant Saudi e-invoices through Saudi VAT Pro.

B75/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B75/100

full report

Adoption

New

0 stars30 downloads/wk

Reviews

Write one

Nobody has reviewed Saudi Vat Pro yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Saudi Vat Pro tools (9, 2 write)

write = sends, deletes, buys or posts

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.

Public scan report

scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it

no findings

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 38 days ago12/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Saudi Vat Pro compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 75/100; higher than 45% of 48,243 servers
Tools: 9; the typical server has 7
Tools that change things: 22%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 30; more than 18% of 12,306 servers with a package

What its tools let an agent do: 7 read · 2 create

Install Saudi Vat Pro in Claude Code, Cursor or VS Code

Runs npx -y saudi-vat-pro-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add saudi-vat-pro -- npx -y saudi-vat-pro-mcp

Add to Cursor

What the publisher says

From the Saudi Vat Pro repository's README, as published. We do not edit it. Read it on GitHub

Saudi VAT Pro — ZATCA Phase 2 E-Invoicing

saudivat.pro automates ZATCA Phase 2 e-invoicing for Saudi Arabian businesses — WooCommerce stores, Shopify merchants, and custom integrations via REST API.

Every paid order becomes a ZATCA-compliant invoice. Every refund becomes a credit note. No developers required.

What's in this repo

The Platform

→ Sign up free at saudivat.pro

Saudi VAT Pro handles the complexity of ZATCA Phase 2 compliance so you don't have to:

CSID onboarding — generate your Cryptographic Stamp Identifier in 5 minutes with the free CSID wizard
B2B clearance — standard invoices cleared with ZATCA in real time before delivery
B2C reporting — simplified invoices reported within 24 hours
Credit notes — refunds automatically generate ZATCA-compliant credit notes
Issue dashboard — plain-language explanations of every ZATCA rejection, with suggested fixes
Retry & repair — re-submit failed invoices without touching code

Supported platforms

AI Agents & Model Context Protocol

The Saudi VAT Pro MCP server lets MCP-compatible AI assistants create and manage ZATCA invoices through the Saudi VAT Pro API.

{
  "mcpServers": {
    "saudi-vat-pro": {
      "command": "npx",
      "args": ["saudi-vat-pro-mcp"],
      "env": {
        "SAUDI_VAT_PRO_API_KEY": "svp_live_YOUR_KEY_HERE"
      }
    }
  }
}

Available tools cover invoice listing and details, standard and simplified invoice creation, idempotent credit notes, failed-invoice retries and explanations, merchant details, dashboard summaries, and ZATCA certificate readiness.

The server gives agents explicit ZATCA safeguards:

Standard B2B invoices require buyer name, city, and a valid 15-digit VAT number
VAT categories, rates, VATEX exemption reasons, and line discounts are validated before submission
Sandbox and production environments are clearly distinguished
Credit-note retries require an idempotency key to prevent duplicate refunds
Every result exposes its actual lifecycle status instead of assuming clearance or reporting succeeded

Canonical links

Source: mcp-server/
Setup and API key: saudivatpro.com/docs#aiagents
npm: saudi-vat-pro-mcp
Official MCP Registry: io.github.Morouna1/saudi-vat-pro

Free Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Saudi Vat Pro: common questions

Is Saudi Vat Pro MCP server safe?: Mostly: it is graded B (75/100). Read the Saudi Vat Pro safety report
How do I install Saudi Vat Pro?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop 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 59 days ago (2026-09-07). The latest release is v1.0.1.
How does Saudi Vat Pro compare with other MCP servers?: safety score 75/100 (higher than 45% of 48,243 servers); tools 9 (the typical server has 7); tools that change things 22% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.