Simple Fatoora MCP. Automated ZATCA-Compliant Invoicing from Chat.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Simple Fatoora connects your AI agent directly to ZATCA-compliant e-invoicing for Saudi businesses. This server lets you manage clients, track inventory, and generate simplified or VAT invoices—all through natural conversation.
It handles automated tax calculations and embeds the required QR codes, eliminating manual accounting headaches.
What your AI agents can do
Create client
Creates a brand-new customer profile in your database.
Create item
Adds a new product or service to your item catalog for billing purposes.
Create simplified invoice
Generates a simplified tax invoice (B2C) by taking items and client details as input.
The agent uses create_client to establish a new contact profile within your Simple Fatoora account.
You prompt the server, and it runs create_simplified_invoice, generating a tax invoice for consumers with automated compliance checks.
The agent can list all existing clients using list_clients or fetch specific details by calling get_client(ID).
It uses list_invoices to pull a summary of your accounts receivable, showing statuses like 'Paid' or 'Draft'.
The agent executes create_item or update_client to ensure your product list and customer data remain current.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 CompatibleWaiting for input…
Simple Fatoora MCP Server: 11 Tools for E-Invoicing
Use these tools to manage client data, create VAT or simplified invoices, and monitor all financial records within the Simple Fatoora system.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Simple Fatoora on Vinkius019dd15dcreate client
Creates a brand-new customer profile in your database.
019dd15dcreate item
Adds a new product or service to your item catalog for billing purposes.
019dd15dcreate simplified invoice
Generates a simplified tax invoice (B2C) by taking items and client details as input.
019dd15dcreate vat invoice
Creates a full VAT tax invoice (B2B) using specific item and client data payloads.
019dd15ddelete client
Removes an existing client record from your system entirely.
019dd15dget client
Retrieves all specific details for one client using their unique ID number.
019dd15dget invoice
Fetches the complete data and status of a single invoice record by its ID.
019dd15dlist clients
Retrieves a comprehensive list of every client currently in your database.
019dd15dlist invoices
Pulls a summary list of all invoices, showing their status and IDs.
019dd15dlist items
Lists every product or service available in your catalog, including current pricing.
019dd15dupdate client
Modifies details (like address or tax ID) for an already existing client profile.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Simple Fatoora, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Manually tracking invoice status across multiple apps wastes hours every month.
Today, getting a clear picture of outstanding invoices means logging into your main accounting platform, then switching to the compliance portal just to verify tax rates. You copy IDs from one screen and paste them into another, spending half an hour just building the data set before you can even write the invoice.
With this MCP server, the agent handles the whole thing in conversation. You ask it: 'What are all unpaid invoices for last week?' It runs `list_invoices` instantly, giving you a precise summary of status and amounts without any copy-pasting.
Simple Fatoora MCP Server gives instant control over your client data.
Before this tool, finding out if a new contact was already registered meant opening the CRM, searching by name, and hoping you didn't miss an old profile. If you needed to update their VAT ID, you had to find that record and manually change the field.
Now, your agent validates everything. You simply tell it: 'Check client XYZ.' It runs `get_client` immediately. Need to change something? Use `update_client`. It's all done in one chat thread.
What you can do with this MCP connector
Simple Fatoora connects your AI agent right to ZATCA-compliant e-invoicing for Saudi businesses. You're running core accounting tasks—managing clients, tracking inventory, and generating simplified or VAT invoices—all through natural conversation. It handles automated tax calculations and embeds the required QR codes; you won't have any manual accounting headaches.
Client Records Management
You can keep your client book clean with several tools. To start fresh, you tell your agent to run create_client, which builds a brand-new customer profile in your database. Need to fix an address or update a tax ID? Use update_client on an existing record. If the client is gone for good, you'll use delete_client to wipe that record entirely.
When you need to know who you're dealing with, you have options: Run list_clients and you get a full roster of every single client currently in your system. Or, if you just know the ID number, calling get_client(ID) pulls all specific details for that one person. If you're managing contacts regularly, these tools let you handle everything from creation to deletion.
Product and Catalog Management
Making sure your product list is accurate is key. You can pull a summary of every item or service you sell by running list_items, which also shows the current pricing for each one. If you have a new widget or a service that didn't make the cut, you just run create_item to add it straight into your billing catalog.
This keeps everything accurate when an invoice needs generating.
Invoice Generation and Tracking
The server provides specialized tools for creating invoices. For consumers (B2C), running create_simplified_invoice generates a simplified tax invoice, automatically checking all the compliance boxes you need. When you deal with other businesses (B2B) that require full VAT documentation, calling create_vat_invoice handles that complex payload using specific client and item data to ensure total adherence to regulations.
You don't just create invoices; you track 'em. Running list_invoices gives you a high-level summary of all your accounts receivable, showing statuses like 'Paid,' 'Draft,' or whatever state the invoice is in. If you need the full scoop on one specific bill—maybe to check if it was paid out yet—you use get_invoice(ID) to fetch the complete data and current status for that single record.
Operational Flow
Your AI agent acts like a dedicated finance manager sitting next to you. You tell your agent exactly what job needs doing—for example, 'Invoice John Doe for 500 SAR using simplified rates.' The agent then automatically calls the sequence of tools required: it'll validate that client first, confirm the items exist in the catalog, and finally execute create_simplified_invoice.
This process handles every compliance detail, including tax calculations and QR code embedding, without you having to switch tabs or manually enter anything.
019dd15d-fdf5-73ab-b1a4-c773a20a45d1 How Simple Fatoora MCP Works
- 1 First, authorize the connection by subscribing to the server and providing your Simple Fatoora API Key.
- 2 Next, direct your AI client to perform a task, such as asking it to 'Create an invoice for Client XYZ.'
- 3 The agent sequences the necessary tool calls (e.g.,
get_clientthencreate_vat_invoice), handles the tax calculations, and returns a confirmation of the compliant record.
The bottom line is that your AI client acts as an automated finance operations manager, executing complex multi-step financial tasks through simple conversation.
Who Is Simple Fatoora MCP For?
This tool is essential for any small to medium business operating in Saudi Arabia who handles invoicing. It's built for the accountant tired of manually cross-referencing VAT rates, or the owner who needs immediate invoice generation without jumping between accounting software and tax compliance portals.
Uses list_invoices to get a quick overview of all pending records, then uses specific tools like get_invoice(ID) to pull the full details for reconciliation.
Runs multi-step prompts that trigger client validation (get_client) followed by invoice creation (create_vat_invoice), ensuring every transaction is compliant.
Needs to generate an immediate, simplified tax invoice for a new sale. They simply ask the agent to 'Invoice John Doe for X amount,' and the system handles everything else.
What Changes When You Connect
- Stop manually calculating tax rates. When you generate an invoice using
create_simplified_invoiceorcreate_vat_invoice, the server handles all automated calculations and compliance checks instantly. - Never lose client data again. You can run
list_clientsto see every recorded customer, or useget_client(ID)to pull detailed contact and tax info for a specific person. - Keep your product catalog accurate with
create_item. Before billing, you can list all available items usinglist_itemsand verify pricing before generating any invoice. - Accountability is clear. By calling
get_invoice(ID), you don't just get the document; you get its full metadata and current status (Paid/Draft), letting you track accounts receivable without logging into a separate dashboard. - Reduce clicks by managing data flow. Instead of updating client info in one place and items in another, you use
update_clientorcreate_itemdirectly via natural language commands.
Real-World Use Cases
End-of-Month Reconciliation
The finance manager needs to reconcile 30 days of sales. Instead of downloading reports and comparing spreadsheets, they ask the agent: 'Show me all invoices from last month that are marked as Draft.' The system runs list_invoices and filters them instantly, providing a clear list for follow-up.
Onboarding a New Partner
A new B2B client signs on. The sales team asks the agent to create a profile: 'Create a client named Global Tech with VAT ID 12345.' This triggers create_client and saves all necessary tax details immediately, ready for billing.
Correcting an Old Invoice
A product price changed. Instead of manually updating old records, the operations manager tells the agent: 'Update item ID 50 to $120.' This runs create_item or equivalent update tool, ensuring all future invoices use the correct pricing.
Generating a Quick Invoice
A client calls with an immediate need for billing. The agent takes their name and item details, running get_client(ID) first to validate tax info, then calling create_simplified_invoice using the validated data.
The Tradeoffs
Assuming Client Data Exists
The user immediately tries to create an invoice by asking: 'Invoice John Doe for 500 SAR.' If John Doe isn't in the system, the process fails and stalls.
→
Always validate first. Before creating a tax document, ask your AI agent to run get_client using the client's name or ID. This confirms they are ready for invoicing.
Manual Data Copying
The user copies item descriptions and prices from a spreadsheet into the chat prompt, risking formatting errors or missed characters.
→
Use list_items first. This pulls the definitive catalog data directly to your agent's context, guaranteeing accuracy for both B2B and B2C billing.
Ignoring Client Updates
A client changes their physical address or tax ID, but the user continues generating invoices using old stored data.
→
Use update_client whenever a core piece of customer information—like VAT number or billing address—changes. This ensures compliance for future invoicing.
When It Fits, When It Doesn't
You should use Simple Fatoora if your primary need is generating ZATCA-compliant invoices and managing client/item data within the KSA tax framework, without needing a full ERP system. It excels at transactional operations: creating records (create_client, create_vat_invoice) and retrieving specific state information (get_invoice). Don't use it if you need payment gateway integration or complex ledger accounting (e.g., posting to general ledgers)—you'll need a dedicated financial platform for that. If your only goal is simply listing clients, the list_clients tool handles that perfectly and quickly.
Common Questions About Simple Fatoora MCP
How do I generate an invoice for a B2B client using the create_vat_invoice tool? +
You prompt your agent to run create_vat_invoice and provide the items as a JSON string. The system requires specific item details and passes them through automated tax calculations, ensuring full VAT compliance.
Does Simple Fatoora MCP Server handle simple invoices for consumers? +
Yes. Use create_simplified_invoice when billing a consumer (B2C). This tool is specifically designed to generate the simplified tax invoice while maintaining ZATCA compliance.
What if I need to change an item's price? Should I use create_item or update_client? +
Item prices belong in your product catalog. You must run create_item or a similar dedicated function for pricing changes, as the client details are handled by update_client.
Can I find out if a client exists before invoicing? +
Absolutely. Run get_client(ID) to retrieve all known data on that person using their ID. This confirms the record is active and complete before you attempt any billing.
What API key credentials do I need to use the `list_clients` tool? +
You must provide your Simple Fatoora API Key from your dashboard settings. This key authorizes your AI client to access and read all your account data, allowing you to list clients successfully.
If I need to adjust a client's tax number or contact info, how does the `update_client` tool work? +
The update_client tool modifies specific fields of an existing record using the provided Client ID. You only send the data you want to change; it won't overwrite other untouched profile details.
What should I do if the item JSON string fails validation when calling `create_vat_invoice`? +
The agent will return a specific error message detailing exactly which field or format is incorrect. Check the required structure of your items before retrying the invoice creation command.
Does running the `delete_client` tool permanently remove all data associated with that client? +
Yes, calling delete_client removes the record from Simple Fatoora. This action is final and irreversible; always verify the Client ID before executing the deletion command.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.