Docs · Updated 2026-09-29
Saudi Business Toolkit — tool reference
VAT, CR, IBAN, Hijri dates and GCC phones for Saudi and Gulf invoices.
Server URL: https://toolcargo.com/mcp/saudi-business · Scope: connector:saudi-business · Included with Site Audit. Not counted.
Older single-tool endpoints (for example /mcp/vat-ksa) stay live for existing keys. Prefer this server so the assistant sees every tool in one place.
calculate_vat
Net, VAT and gross from an exclusive or inclusive SAR amount. Not a ZATCA invoice.
calculate_gcc_vat
Standard rates: SA 15%, AE 5%, BH 10%, OM 5%, KW/QA 0%, EG 14%. Not a filing.
amount_in_words
One thousand one hundred fifty SAR only. English, not Arabic tafqeet.
calculate_discount
Percent off a price, or derive the percent from a sale price. Not VAT.
calculate_margin
Sell from cost and margin %, or margin/markup from cost and sell. Margin is on sell price.
format_invoice_number
INV-YYYYMM-0001 style. You pass the sequence; we do not reserve it in a ledger.
validate_iban
Check ISO 13616 check digits and known length for SA, AE, EG, KW and common EU countries. Does not contact a bank.
check_cr
10 digits. Does not look up the Ministry of Commerce.
check_vat_id
15 digits starting and ending with 3. Not a ZATCA lookup.
check_postal
5 digits (Wasel). Not an address lookup.
to_hijri
Convert a YYYY-MM-DD Gregorian date to a Hijri (Umm al-Qura when available) reading.
add_working_days
Add or subtract business days. Default weekend is Friday–Saturday (KSA/Gulf).
format_phone
Normalise a Saudi, UAE, Egypt, Kuwait, Qatar, Bahrain or Oman mobile to E.164 and national form. Does not send SMS.
convert_numerals
0123 ↔ ٠١٢٣. Letters are left alone.
strip_tashkeel
Remove harakat (and tatweel by default) so search and slugs match undiacritized copy.