Skip to content
ToolCargo

Saudi Business Toolkit

Live

VAT, CR, IBAN, Hijri dates and GCC phones for Saudi and Gulf invoices.

15% KSA VAT and GCC rates, amounts in words, discount and margin vs markup, invoice numbers, IBAN and Saudi CR / VAT ID / postal format checks, Hijri dates, working days (KSA weekend default), GCC E.164 phones, Eastern Arabic numerals and tashkeel strip. ZATCA e-invoices stay a separate connector.

Start freeTool reference

Server URL

streamable http
https://toolcargo.com/mcp/saudi-business

Claude Code

terminal
claude mcp add --transport http --scope user toolcargo-saudi-business https://toolcargo.com/mcp/saudi-business \
  --header "Authorization: Bearer YOUR_API_KEY"

Create a key in your dashboard. Other clients: setup guides.

What it helps you do

  • KSA 15% VAT and GCC standard rates from the same server.
  • Format checks for CR, VAT ID, IBAN and Wasel postcodes.
  • Hijri dates, working days, GCC phones, Eastern numerals.

Built for: Saudi and Gulf SMBs who draft invoices and listings from an assistant.

Example requests

Quote VAT

“Add 15% KSA VAT to 1000 SAR exclusive, and the amount in words.”

VAT 150, total 1150, plus English words.

Check identifiers

“Is this Saudi VAT ID and CR number the right shape?”

Format ok or the specific problem.

Working days

“Add 5 working days from 2026-09-29, KSA weekend.”

A UTC date skipping Friday and Saturday.

Step-by-step workflows: pre-launch check · fixing link previews

Tools

ToolWhat it doesAccess
calculate_vat
Calculate KSA 15% VAT
Net, VAT and gross from an exclusive or inclusive SAR amount. Not a ZATCA invoice.Read-only
calculate_gcc_vat
Calculate GCC / Egypt VAT
Standard rates: SA 15%, AE 5%, BH 10%, OM 5%, KW/QA 0%, EG 14%. Not a filing.Read-only
amount_in_words
Amount in English words
One thousand one hundred fifty SAR only. English, not Arabic tafqeet.Read-only
calculate_discount
Calculate a discount
Percent off a price, or derive the percent from a sale price. Not VAT.Read-only
calculate_margin
Margin vs markup
Sell from cost and margin %, or margin/markup from cost and sell. Margin is on sell price.Read-only
format_invoice_number
Format an invoice number
INV-YYYYMM-0001 style. You pass the sequence; we do not reserve it in a ledger.Read-only
validate_iban
Validate an IBAN
Check ISO 13616 check digits and known length for SA, AE, EG, KW and common EU countries. Does not contact a bank.Read-only
check_cr
Check a Saudi CR number
10 digits. Does not look up the Ministry of Commerce.Read-only
check_vat_id
Check a Saudi VAT number
15 digits starting and ending with 3. Not a ZATCA lookup.Read-only
check_postal
Check a Saudi postal code
5 digits (Wasel). Not an address lookup.Read-only
to_hijri
Gregorian to Hijri
Convert a YYYY-MM-DD Gregorian date to a Hijri (Umm al-Qura when available) reading.Read-only
add_working_days
Add working days
Add or subtract business days. Default weekend is Friday–Saturday (KSA/Gulf).Read-only
format_phone
Format a GCC / Egypt mobile
Normalise a Saudi, UAE, Egypt, Kuwait, Qatar, Bahrain or Oman mobile to E.164 and national form. Does not send SMS.Read-only
convert_numerals
Eastern / Western Arabic numerals
0123 ↔ ٠١٢٣. Letters are left alone.Read-only
strip_tashkeel
Strip Arabic tashkeel
Remove harakat (and tatweel by default) so search and slugs match undiacritized copy.Read-only

Requirements

  • • A ToolCargo account with Site Audit activated (free).

Limitations

  • • Format and arithmetic only — not a ZATCA or Ministry lookup.
  • • ZATCA Phase-1 invoices are a separate connector.
  • • Single-tool URLs such as /mcp/vat-ksa remain available for existing keys.

Supported clients

“Tested” means we connected that client to this endpoint and ran a tool call ourselves. “Documented” means the client supports this setup per its own docs, but we have not tested it yet.

Claude CodeAPI key headerTestedRemote HTTP server with an Authorization header. Tested 2026-09-11 (v2.1.268).
Claude (claude.ai)OAuth sign-inTestedCustom connector with OAuth sign-in; tested on claude.ai web 2026-09-11. Desktop and mobile use the same account connectors but were not tested separately.
CursorAPI key headerDocumented, not yet testedmcp.json with url and headers.
VS Code (Copilot agent mode)API key headerDocumented, not yet tested.vscode/mcp.json with type http and headers.
ChatGPT (developer mode)OAuth sign-inDocumented, not yet testedRequires OAuth; API keys cannot be entered.
MCP InspectorAPI key headerTestedCLI mode, tested 2026-09-11. Useful for calling tools directly.

More in Invoicing

Pricing

Free

$0

For trying the connector on your own sites.

50 calls/month · 25 links per check

Pro

$12/mo

For freelancers and agencies auditing client sites every week.

2,000 calls/month · 100 links per check

Proposed test price. See the pricing page for checkout status.

Full pricing and billing details