Vinkius
SimpleFatoora

SimpleFatoora MCP. Automate ZATCA-compliant invoicing from chat.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

SimpleFatoora MCP on Cursor AI Code Editor MCP Client SimpleFatoora MCP on Claude Desktop App MCP Integration SimpleFatoora MCP on OpenAI Agents SDK MCP Compatible SimpleFatoora MCP on Visual Studio Code MCP Extension Client SimpleFatoora MCP on GitHub Copilot AI Agent MCP Integration SimpleFatoora MCP on Google Gemini AI MCP Integration SimpleFatoora MCP on Lovable AI Development MCP Client SimpleFatoora MCP on Mistral AI Agents MCP Compatible SimpleFatoora MCP on Amazon AWS Bedrock MCP Support

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.

+ 17 more capabilities included
Generate Compliant Invoices

The agent generates specific types of invoices (B2C, B2B, Purchase) and automatically stamps them to meet ZATCA regulatory requirements.

Manage Customer Records

You can create, read, update, list, or delete full customer profiles, ensuring tax registration numbers are always current for compliance.

Handle Financial Adjustments

The system creates compliant credit notes and debit notes, linking them directly to existing invoices to adjust balances after returns or partial payments.

Maintain Product Catalogs

You control the master data by creating new products, updating VAT rates, and deleting unused items from your product catalog.

Verify Compliance & Status

The agent checks the connectivity status (check_simplefatoora_status) and validates API keys before running any critical transaction.

Supported MCP Clients

OAuth 2.0 Compatible
Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
Vinkius runs on Zendesk Zendesk
+ other MCP clients
Included with Plan

Waiting for input…

AI Agent

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 Vinkius
check019dd15e

check simplefatoora status

Verifies if the SimpleFatoora connection is active and working.

create019dd15e

create credit note

Generates a compliant credit note for an invoice.

create019dd15e

create customer

Creates a new customer profile in the system.

create019dd15e

create debit note

Generates a compliant debit note for an invoice.

create019dd15e

create product

Creates a new product entry in the catalog.

create019dd15e

create simplified purchase

Creates a purchase invoice using the simplified method.

create019dd15e

create simplified invoice

Generates a B2C simplified invoice, suitable for retail sales.

create019dd15e

create standard purchase

Generates a standard, full-detail purchase invoice.

create019dd15e

create vat invoice

Creates a compliant B2B VAT invoice for registered businesses.

delete019dd15e

delete customer

Permanently removes a customer from the system records.

delete019dd15e

delete product

Removes a product entry from the catalog.

get019dd15e

get customer

Retrieves all details for a specific customer by ID.

get019dd15e

get invoice

Fetches the full data and status of an existing invoice number.

get019dd15e

get product

Retrieves all details for a specific product code or ID.

list019dd15e

list customers

Returns a list of multiple customers, often filtered by criteria like VAT number.

list019dd15e

list invoices

Retrieves a paginated list of all invoices generated in the account.

list019dd15e

list products

Returns a complete list of all products available in the catalog.

update019dd15e

update customer

Modifies existing customer details, like changing an address or tax number.

update019dd15e

update product

Changes product attributes such as price, description, or VAT rate.

validate019dd15e

validate 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
Start building

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
SimpleFatoora MCP server cover

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

Your data is protected. See how we built it.

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.

Built · Hosted · Managed by Vinkius SimpleFatoora MCP Server - ZATCA Invoicing & Tax Management Server ID 019dd15e-5ef2-7300-b205-deba263ff37b
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

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.

Built & Managed by Vinkius 30s setup 20 tools

We've already built the connector for SimpleFatoora. Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 20 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.