NestDaddy

ZATCA e-invoicing (Saudi Fatoora)

io.github.SalmanKhan957/zatca-toolkit · v0.1.1

Create, sign, validate and submit Saudi ZATCA Phase 2 e-invoices; decode QR codes; explain errors.

Connect Runs on your machine

Terminal
claude mcp add zatca-toolkit -e ZATCA_ENV=<ZATCA_ENV> -e ZATCA_PRIVATE_KEY_FILE=<ZATCA_PRIVATE_KEY_FILE> -e ZATCA_CERTIFICATE=<ZATCA_CERTIFICATE> -e ZATCA_CSID_SECRET=<ZATCA_CSID_SECRET> -e ZATCA_SELLER_FILE=<ZATCA_SELLER_FILE> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "zatca-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ZATCA_ENV": "<ZATCA_ENV>",
        "ZATCA_PRIVATE_KEY_FILE": "<ZATCA_PRIVATE_KEY_FILE>",
        "ZATCA_CERTIFICATE": "<ZATCA_CERTIFICATE>",
        "ZATCA_CSID_SECRET": "<ZATCA_CSID_SECRET>",
        "ZATCA_SELLER_FILE": "<ZATCA_SELLER_FILE>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "zatca-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ZATCA_ENV": "<ZATCA_ENV>",
        "ZATCA_PRIVATE_KEY_FILE": "<ZATCA_PRIVATE_KEY_FILE>",
        "ZATCA_CERTIFICATE": "<ZATCA_CERTIFICATE>",
        "ZATCA_CSID_SECRET": "<ZATCA_CSID_SECRET>",
        "ZATCA_SELLER_FILE": "<ZATCA_SELLER_FILE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "zatca-toolkit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "ZATCA_ENV": "<ZATCA_ENV>",
        "ZATCA_PRIVATE_KEY_FILE": "<ZATCA_PRIVATE_KEY_FILE>",
        "ZATCA_CERTIFICATE": "<ZATCA_CERTIFICATE>",
        "ZATCA_CSID_SECRET": "<ZATCA_CSID_SECRET>",
        "ZATCA_SELLER_FILE": "<ZATCA_SELLER_FILE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
ZATCA_ENV
Optional
sandbox (default), simulation or production
ZATCA_PRIVATE_KEY_FILE
Optional
Path to the EGS secp256k1 private key (PEM)
ZATCA_CERTIFICATE
Optional, secret
CSID certificate or binarySecurityToken from ZATCA
ZATCA_CSID_SECRET
Optional, secret
CSID secret, needed to submit invoices
ZATCA_SELLER_FILE
Optional
Path to seller details JSON

Details

Package[email protected] (NPM, stdio)
First published14 Nov 2026
Last updated14 Nov 2026
Registry nameio.github.SalmanKhan957/zatca-toolkit

More finance and crypto servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.