SimpleFatoora MCP. Automate 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.
SimpleFatoora connects your AI client to SimpleFatoora for full ZATCA-compliant e-invoicing. It gives your agent programmatic access to generate all six required invoice types (B2C, B2B, Purchase) and manage every detail: customers, products, tax rates, and credit notes.
What your AI agents can do
Check simplefatoora status
Verifies if the SimpleFatoora connection is active and working.
Create credit note
Generates a compliant credit note for an invoice.
Create customer
Creates a new customer profile in the system.
The agent generates specific types of invoices (B2C, B2B, Purchase) and automatically stamps them to meet ZATCA regulatory requirements.
You can create, read, update, list, or delete full customer profiles, ensuring tax registration numbers are always current for compliance.
The system creates compliant credit notes and debit notes, linking them directly to existing invoices to adjust balances after returns or partial payments.
You control the master data by creating new products, updating VAT rates, and deleting unused items from your product catalog.
The agent checks the connectivity status (check_simplefatoora_status) and validates API keys before running any critical transaction.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 CompatibleWaiting for input…
SimpleFatoora MCP Server: 20 Tools for Financial Ops
These tools let your agent perform every core financial operation required in Saudi Arabia, from creating invoices to maintaining customer and product data.
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 SimpleFatoora on Vinkius019dd15echeck simplefatoora status
Verifies if the SimpleFatoora connection is active and working.
019dd15ecreate credit note
Generates a compliant credit note for an invoice.
019dd15ecreate customer
Creates a new customer profile in the system.
019dd15ecreate debit note
Generates a compliant debit note for an invoice.
019dd15ecreate product
Creates a new product entry in the catalog.
019dd15ecreate simplified purchase
Creates a purchase invoice using the simplified method.
019dd15ecreate simplified invoice
Generates a B2C simplified invoice, suitable for retail sales.
019dd15ecreate standard purchase
Generates a standard, full-detail purchase invoice.
019dd15ecreate vat invoice
Creates a compliant B2B VAT invoice for registered businesses.
019dd15edelete customer
Permanently removes a customer from the system records.
019dd15edelete product
Removes a product entry from the catalog.
019dd15eget customer
Retrieves all details for a specific customer by ID.
019dd15eget invoice
Fetches the full data and status of an existing invoice number.
019dd15eget product
Retrieves all details for a specific product code or ID.
019dd15elist customers
Returns a list of multiple customers, often filtered by criteria like VAT number.
019dd15elist invoices
Retrieves a paginated list of all invoices generated in the account.
019dd15elist products
Returns a complete list of all products available in the catalog.
019dd15eupdate customer
Modifies existing customer details, like changing an address or tax number.
019dd15eupdate product
Changes product attributes such as price, description, or VAT rate.
019dd15evalidate api key
Checks if the provided API key is valid and active for SimpleFatoora.
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 SimpleFatoora, 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 SimpleFatoora. 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 20 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Manually reconciling billing records is a nightmare.
Right now, when you close the books, someone has to jump between three places: the ERP system for customer data, a spreadsheet for pricing changes, and the invoicing portal for generation. You spend hours copying IDs, cross-referencing VAT numbers, and making sure every credit note links back perfectly.
With this MCP server, those steps vanish. You just tell your agent to 'Process all invoices for Acme Corp.' The system uses `get_customer` first, then pulls the latest products via `list_products`, and generates a compliant invoice in seconds. It's one command instead of five tabs.
SimpleFatoora MCP Server: Automated B2B VAT Invoicing
Before this, generating a proper B2B VAT invoice meant manually verifying the client's tax status and ensuring the correct six-digit ZATCA stamp was applied to the document. If you missed one field or used the wrong tool, the invoice was rejected by auditors.
Now? You ask your agent for the `create_vat_invoice`. It handles all that complex logic internally—the VAT calculations, the formatting, and the required stamps. The result is a fully compliant document ready to send.
What you can do with this MCP connector
Listen up. If you're dealing with billing in Saudi Arabia, you need this SimpleFatoora server hooked up to your agent. It handles all the complicated stuff—making sure every invoice is 100% ZATCA compliant. Your agent gets programmatic access to generate six different types of invoices and keeps track of every detail: who bought it, what was sold, and how much tax applies.
Before running anything, your agent first checks things out. You'll use validate_api_key to confirm the API key is valid and active. It's also smart enough that you can run check_simplefatoora_status right away; that tells you if the whole SimpleFatoora connection is up and working before you try to send a single dollar.
Generating Compliant Invoices. This server lets your agent create specific documents required by law. To handle retail sales, it'll use create_simplified_invoice for B2C simplified billing. For registered businesses doing VAT transactions, the agent uses create_vat_invoice to generate a compliant B2B VAT invoice. If you're dealing with purchases, it gives you two options: running create_standard_purchase for full-detail purchase invoices or using create_simplified_purchase if that’s what fits your needs.
You don't just create invoices; you adjust them too. When a customer returns something, the agent runs create_credit_note, generating a compliant credit note linked right to the original invoice. If there's an overpayment or some other adjustment needed, it uses create_debit_note to generate that official debit note.
Managing Customer Profiles. You can build and maintain your entire customer database using these tools. To start someone new, you run create_customer. Need the details on a specific client? Use get_customer with their ID; otherwise, you can pull up multiple clients by running list_customers, often filtering them by things like VAT number.
If an address changes or they get a tax update, you just call update_customer. When a customer account is totally defunct and needs to be wiped from the system records, you use delete_customer.
Handling Product Catalogs. The agent keeps your master data clean too. To add new services or items, it uses create_product; if you need details on an existing item, run get_product with the code or ID. Want to see everything you've sold? list_products pulls a complete list of all available products.
If the price goes up or the VAT rate changes, you use update_product. And if a product line is dead and needs removing entirely from your catalog records, it uses delete_product.
Checking Records. You don't have to guess what happened with an invoice number. get_invoice pulls up all the data and current status for any existing invoice you provide. If you need a full history of everything generated in the account, run list_invoices to get a paginated list of every invoice.
You can also call list_products again just to verify what's sitting in your catalog.
This setup gives your agent total control over the entire financial lifecycle. You manage the client data, you keep the product codes fresh, and you generate every single document—from the initial B2C invoice to the final debit note—all while staying compliant with ZATCA regulations. It’s a full-stack solution; it's built for real business use.
019dd15e-5ef2-7300-b205-deba263ff37b How SimpleFatoora MCP Works
- 1 First, subscribe to this server on Vinkius. You'll need your SimpleFatoora API Key from their developer dashboard.
- 2 Second, enter the required API key into your agent configuration. The agent uses this credential to authenticate all subsequent requests against the SimpleFatoora platform.
- 3 Third, tell your AI client what you want—e.g., 'Create a B2B VAT invoice for customer X.' The agent then executes the necessary tool calls (
create_vat_invoice) and returns the compliant invoice document.
The bottom line is: You connect your API key once, and your AI client handles all the complex billing logic using simple instructions.
Who Is SimpleFatoora MCP For?
This server is built for financial controllers, accountants, and operational managers working in Saudi Arabia. If you deal with high volumes of regulated invoicing, tax compliance, or need to move beyond basic accounting software, this is what you need. It cuts out the manual data entry steps that keep people up at 2 am.
Runs end-of-month reporting, listing all invoices (list_invoices) and cross-referencing them with customer records to ensure nothing is missing for tax filing.
Manages the master data. They use tools like create_product or update_customer to keep the entire product catalog and client details accurate before billing runs start.
Handles daily transaction volume, instructing the agent to create invoices (create_simplified_invoice) and process adjustments like credit notes for returns on demand.
What Changes When You Connect
- Generate all six compliant invoice types in one step. Whether it's a simplified B2C sale or a complex B2B VAT invoice, the agent runs
create_vat_invoiceand handles the required cryptographic stamp automatically. - Never manually update customer data again. Use
list_customersto audit your roster, then useupdate_customerwhen an address or tax number changes, keeping records accurate for audits. - Manage the whole product lifecycle. If a price changes or a VAT rate shifts, you don't touch spreadsheets; you simply call
update_product, and the master catalog is correct immediately. - Handle returns without headaches. When a customer returns goods, your agent calls
create_credit_note(orcreate_debit_note) against the original invoice number, maintaining full compliance history. - Run high-level audits effortlessly. You can ask to see all invoices for last quarter and get them via
list_invoices, giving you a clean, structured data set ready for export.
Real-World Use Cases
The End-of-Month Reconciliation
An accountant needs to reconcile all sales. They ask their agent to 'List all invoices from the last 30 days.' The agent runs list_invoices, compiles the data, and groups it by invoice type (VAT vs. Simplified), giving the controller a clean summary ready for tax filing.
Customer Data Correction
A sales rep learns a client changed their VAT registration number. Instead of calling finance to update an internal sheet, they tell their agent: 'Update customer XYZ with new VAT number.' The agent calls update_customer, ensuring the next invoice generated will be compliant.
Processing Returns
A warehouse manager processes a partial return for Invoice #4567. They tell their agent, 'Create a credit note for 10 units from Invoice #4567.' The agent runs create_credit_note, linking the adjustment and stamping it for ZATCA compliance.
New Product Launch
The product team launches a new service. Instead of updating multiple spreadsheets, they ask their agent to 'Add the new service as product code SVC-001.' The agent calls create_product, adding it with correct VAT rates and immediately making it available for invoicing.
The Tradeoffs
Trying to adjust an invoice manually
A user finds the old paper copy of Invoice #1234 and tries to write a 'Credit' amount on it, assuming that’s enough for compliance.
→
Don't touch the original document. Use your agent to run create_credit_note against the specific invoice number (#1234). This generates a new, compliant digital record that officially adjusts the total.
Listing all invoices without filtering
Calling 'list_invoices' and getting 5,000 records when you only needed the VAT ones from last week. The data dump is useless.
→ Be specific in your prompt. Ask: 'List all B2B VAT invoices for June.' This lets the agent narrow the search parameters to give you exactly what you need.
Using a product ID that doesn't exist
Trying to generate an invoice using a product name ('Widget Pro') that was misspelled or deleted from the catalog.
→
Always run list_products first. Then, use get_product with the confirmed SKU/ID before attempting to create any invoice.
When It Fits, When It Doesn't
Use this server if your core business process revolves around B2B or B2C billing within Saudi Arabia, and compliance (ZATCA) is non-negotiable. If you need to generate standardized, legally stamped invoices, this is the only toolset that handles the full lifecycle—from creating a product (create_product) to issuing a final credit note (create_credit_note).
Don't use it if your primary goal is simply data storage without an invoicing component (e.g., just tracking inventory levels). For pure, non-financial record keeping, you need a different type of database tool. If you only generate simple internal receipts that never touch tax law, this might be overkill, but for any money changing hands in KSA, it's necessary.
Common Questions About SimpleFatoora MCP
How do I generate a B2B invoice using SimpleFatoora? +
You use the create_vat_invoice tool. This function handles all required B2B VAT logic, ensuring compliance with ZATCA standards and generating the correct document type.
What is the difference between `create_credit_note` and `create_debit_note`? +
create_credit_note reduces a customer's balance (used for returns or overpayment). create_debit_note increases it, usually when you charge back an amount.
Can I update product prices using the SimpleFatoora MCP Server? +
Yes. Use the update_product tool. This function lets you change price points and VAT rates for specific products without affecting historical invoices or customer data.
How do I list all my customers in SimpleFatoora? +
Call the list_customers tool. It returns a list of registered clients, which you can then filter by criteria like VAT number or date range.
How do I check if my SimpleFatoora API key is working using the `validate_api_key` tool? +
Running this tool confirms your credentials are active and correctly formatted. It provides a simple pass/fail status, letting you know immediately whether to continue building or if you need to update your keys.
What specific details can I pull for one transaction using the `get_invoice` tool? +
The get_invoice tool retrieves every piece of data tied to a single invoice ID. You get the total amount, customer information, VAT breakdown, and the full status necessary for auditing or display purposes.
How do I retrieve all my registered products using the `list_products` tool? +
This command pulls a complete list of every item in your product catalog. You get names, unique IDs, current prices, and associated VAT rates across all entries.
What is the process for generating a simplified consumer invoice using `create_simplified_invoice`? +
To create a B2C invoice, you use this tool to handle transactions that don't require full VAT complexity. You provide the items and total amount, and it generates the necessary ZATCA-compliant document.
How can my AI generate ZATCA-compliant invoices? +
Simply use the create_invoice tool. Your agent can instantly generate six types of invoices (including B2C and B2B), all fully compliant with ZATCA Phase 2, complete with QR codes, UUIDs, and cryptographic stamps.
Is it possible to programmatically access my client list and VAT numbers? +
Yes. By executing the list_customers action, your AI agent can retrieve your entire client registry, including tax identification numbers, addresses, and contact details for seamless CRM integration.
Can I automatically issue credit notes for partial returns? +
Absolutely. Ask the agent to use the create_credit_note tool. It will safely generate a ZATCA-compliant credit note linked to the original invoice, adjusting the accounting records automatically.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.