How to Use the Simple Fatoora MCP in Claude

Q: How do I check Simple Fatoora VAT invoice details with Claude Desktop?

You use the getinvoice tool. Simply provide the invoice ID, and your agent will pull up all the required ZATCA fields and tax calculations for you.

Q: Does Simple Fatoora support multi-client operations via Claude Desktop?

Yes. You can use listclients to fetch a full list of existing customers. This allows your agent to process batch updates or verify client existence before running an invoice.

Q: Can I delete a client record using Simple Fatoora with Claude Desktop?

Absolutely. Use the deleteclient tool when an account is permanently closed to keep your database clean and accurate.

Q: Which function generates the B2C simplified invoice for Simple Fatoora with Claude Desktop?

The createsimplifiedinvoice tool handles all the necessary steps. You just feed it a JSON string of items, and it returns the complete billing record.

Generate ZATCA-compliant invoices and manage client data directly from your local machine using Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Simple Fatoora MCP to Claude Desktop

Create your Vinkius account to connect Simple Fatoora to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Simple Fatoora with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Process simplified B2C tax invoices

You can generate a Simplified Tax Invoice (B2C) for quick sales. Just pass the item details as a JSON string to `create_simplified_invoice`. This process ensures that every invoice meets basic local requirements, letting you focus on cash flow instead of tax forms.

Handle complex B2B VAT billing

Need to bill another business? The `create_vat_invoice` tool handles full VAT compliance. You provide the items as JSON, and it generates a fully ZATCA-compliant invoice. This is critical for formal transactions because it embeds the necessary QR code data right into the billing record.

Manage client and item records

Keep your books straight by managing core reference data. Use `create_client` to add a new customer, or run `list_clients` to see everyone you've billed. You can also manage inventory using `create_item` and keep all product definitions in one place.

Setup guide

Set up Simple Fatoora MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Simple Fatoora MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Simple Fatoora MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under simple-fatoora-mcp.

json

{
  "mcpServers": {
    "simple-fatoora-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Simple Fatoora. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Simple Fatoora now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Simple Fatoora MCP in Claude Desktop

You use the `get_invoice` tool. Simply provide the invoice ID, and your agent will pull up all the required ZATCA fields and tax calculations for you.

Yes. You can use `list_clients` to fetch a full list of existing customers. This allows your agent to process batch updates or verify client existence before running an invoice.

This MCP Server handles customer details, including names and contact information (`create_client`). The data remains within your configured environment or via secure endpoint tokens for processing.

Absolutely. Use the `delete_client` tool when an account is permanently closed to keep your database clean and accurate.

The `create_simplified_invoice` tool handles all the necessary steps. You just feed it a JSON string of items, and it returns the complete billing record.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript