# Simple Fatoora MCP for AI Agents AI Agent Connect

> Simple Fatoora lets you generate ZATCA-compliant electronic invoices for Saudi Arabian businesses using an AI agent. It handles automated tax calculations and QR code embedding while giving you a way to manage your client database and inventory through a natural chat. It's the shortcut for KSA business owners who need to stay compliant without the manual headache of spreadsheet tracking.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_3Xi2aw6iksMkmc4PknPNUbWOndJrJa4lOz7QYmk5/ai-agent-connect
- **Tags:** e-invoicing, zatca-compliance, tax-calculation, qr-code-generation, accounting, saudi-tax

## Description

Simple Fatoora connects your e-invoicing and business financial records to your AI agent. Instead of jumping between tabs to manually enter data, you can manage your entire billing cycle through a single conversation. You can pull up client profiles, check your current stock, and generate compliant tax invoices without leaving your workspace. It's a part of the Vinkius catalog, designed to turn your AI into a dedicated finance manager that understands Saudi tax requirements. You stop worrying about missing a VAT detail or forgetting a QR code because the agent handles the heavy lifting based on your instructions. You can see your accounts receivable organized and your product catalog updated in real-time, making it easy to keep your business running smoothly without the usual paperwork.

## Tools

### create_client
Adds a new customer to your database. This sets up the foundation for future billing and tax tracking.

### create_item
Adds a new product or service to your catalog. Use this to expand your offerings without manual entry.

### create_simplified_invoice
Generates a B2C Simplified Tax Invoice using a JSON string of items. This handles the specific requirements for individual sales.

### create_vat_invoice
Generates a B2B VAT Tax Invoice using a JSON string of items. This ensures your business-to-business billing stays compliant.

### delete_client
Removes a specific client from your database. This helps keep your records clean and up to date.

### get_client
Pulls the full profile for a client using their ID. You can use this to quickly check tax info or contact details.

### list_clients
Shows every client currently in your system. Use this to get a high-level view of your customer base.

### get_invoice
Fetches the specific details of an invoice by its ID. It's useful for checking the status of a single billing record.

### list_invoices
Displays a list of all invoices in your account. This is the quickest way to see what's been billed recently.

### list_items
Shows every product and service in your inventory. You can use this to see what's currently available for sale.

### update_client
Modifies the information for an existing client. This is how you keep contact details current as your business grows.

## Prompt Examples

**Prompt:** 
```
I just sold a consulting session to a new client called Sarah for 1200 SAR. Can you make a VAT invoice?
```

**Response:** 
```
I've created a VAT Tax Invoice for Sarah. Here are the details:

* **Client:** Sarah
* **Item:** Consulting Session
* **Total:** 1,200 SAR
* **Status:** ZATCA-Compliant

Would you like me to send a copy of the invoice details or move on to the next task?
```

**Prompt:** 
```
What items do we currently have in our product catalog?
```

**Response:** 
```
Here is your current inventory:

| Item Name | Status | Price |
| :--- | :--- | :--- |
| Consulting Session | Available | 1,200 SAR |
| Strategy Workshop | Out of Stock | 5,000 SAR |
| Monthly Retainer | Available | 2,500 SAR |

Would you like to add a new item or update the price of any of these?
```

**Prompt:** 
```
Find the tax ID for the client with ID 4521.
```

**Response:** 
```
I've pulled up the details for client 4521:

* **Name:** Acme Corp
* **VAT Registration:** 300123456789
* **Contact:** info@acmecorp.sa
* **Last Invoice:** INV-8829

Do you need me to create a new invoice for them?
```

## Capabilities

### Generate ZATCA-compliant invoices
Create both B2B VAT invoices and B2C simplified invoices with correct tax math.

### Pull up client profiles
Get contact details and tax IDs for your customers instantly through chat.

### Update product catalogs
Add new items or services to your inventory list using natural language commands.

### Monitor billing status
Check which invoices are paid, pending, or still in draft status at any time.

### Clean up customer records
Remove inactive clients from your database to keep your records accurate.

## Use Cases

### Billing a walk-in customer
A retail shop owner needs to bill a walk-in customer. The owner asks the agent to create a simplified invoice for a 500 SAR sale. The agent uses create_simplified_invoice to generate a ZATCA-compliant record immediately.

### Verifying a client's tax status
An accountant needs to check a client's tax status. The accountant asks the agent to find a specific client. The agent uses get_client to pull the VAT number and contact history for a quick review.

### Checking current stock levels
A manager wants to see what's in stock. The manager asks the agent to list all products. The agent uses list_items to provide a real-time inventory count of all available services.

### Onboarding a new B2B partner
A business just signed a new B2B contract. The user tells the agent to add a new company and create a VAT invoice. The agent uses create_client and create_vat_invoice to handle the setup in seconds.

## Benefits

- You no longer have to manually calculate VAT for every sale because create_vat_invoice handles the math automatically.
- You can pull up client tax IDs and contact info instantly using get_client instead of digging through old emails.
- Your inventory stays accurate because you can use create_item and list_items to manage your catalog via chat.
- You save time on data entry by using create_client to build your database as you go.
- You keep your books clean by using delete_client to remove inactive records without navigating a complex UI.
- You get a bird's-eye view of your revenue with list_invoices, making it easier to track what's paid and what's pending.

## How It Works

The bottom line is you get a functional finance department that lives inside your chat interface.

1. Subscribe to the Simple Fatoora MCP and grab your API key from the dashboard.
2. Plug that key into your AI client's configuration settings.
3. Start asking your agent to create invoices or check inventory levels.

## Frequently Asked Questions

**Does Simple Fatoora handle ZATCA requirements?**
Yes, this Connector is specifically built to generate ZATCA-compliant electronic invoices for Saudi businesses. It handles the tax calculations and QR code requirements automatically so you don't have to worry about manual errors.

**Can I use this to manage my client database?**
You can use it to list all your clients, create new ones, and pull up specific profile details like tax IDs and contact info. It makes managing your customer list much faster than using a standard dashboard.

**Does this work for both B2B and B2C sales?**
Yes. The Connector includes tools for both VAT Tax Invoices for business clients and Simplified Tax Invoices for individual customers, ensuring you're covered regardless of who you're billing.

**How do I keep my inventory updated?**
You can ask your agent to list your current items or add new ones to your catalog. This keeps your product list accurate without you having to manually enter data into a separate inventory system.

**Can my AI agent check invoice statuses?**
Yes, you can ask the agent to list your invoices or get the details of a specific one. It's a great way to quickly see which bills are paid, pending, or still in draft status.

**Is this Connector suitable for small businesses in KSA?**
It's perfect for small businesses because it removes the need for complex accounting software. You get a streamlined way to stay compliant and manage your finances through a simple chat interface.

**Can my AI automatically create a ZATCA-compliant VAT invoice for a customer?**
Yes! Use the `create_vat_invoice` tool. Provide the client details and item list, and your agent will generate a compliant ZATCA Phase 2 invoice instantly.

**How do I check the stock level for a specific item in Simple Fatoora?**
Simply ask the agent to run the `list_items` action. It will retrieve the current inventory catalog, including stock counts and pricing for all items.

**How do I find my Simple Fatoora API Key?**
Log in to your Simple Fatoora dashboard, navigate to **Settings** > **API Integration**, and you will find your unique secret API Key there.