# SimpleFatoora MCP for AI Agents AI Agent Connect > SimpleFatoora lets you automate ZATCA-compliant e-invoicing for your Saudi business. It handles B2B and B2C invoices, credit notes, and tax documents while managing your customer and product catalogs. Connect it to your AI agent to handle complex tax compliance and billing tasks through natural language. ## Overview - **Category:** erp-operations - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JF0Az1ToRgS98hqWaJOWOGctzbJvYDqZqB2kVY1k/ai-agent-connect - **Tags:** e-invoicing, zatca-compliance, invoice-management, customer-crud, product-crud, tax-reporting ## Description This Connector lets your AI agent handle the heavy lifting of Saudi Arabian e-invoicing. If you're dealing with ZATCA Phase 2 requirements, you know the paperwork is intense and the margin for error is small. It takes that off your plate by giving your agent the ability to generate every type of compliant invoice, from B2B VAT documents to simplified purchase receipts. Instead of jumping between different tabs to update product prices, check VAT rates, or manually type in customer details, you can just tell your agent what needs to happen in plain English. It keeps your customer profiles and tax registration numbers organized in one place. When you need to issue a credit note for a return, your agent handles the cryptographic stamping and compliance checks automatically, ensuring the final document is valid. It's a way to turn a manual, error-prone accounting process into a conversational workflow where you just give instructions and the agent does the work. By using this Connector through the Vinkius catalog, you get a direct line to your billing operations without having to build out a custom integration from scratch. It makes sure your records stay accurate, your inventory stays current, and your business stays compliant with local tax laws without the usual headaches. ## Tools ### check_simplefatoora_status Check SimpleFatoora status. This verifies your connection to the platform is working. It's a quick way to troubleshoot issues. ### create_credit_note Create a credit note. Use this to issue adjustments or refunds for specific invoices. It handles the compliance stamping for you. ### create_customer Create a customer. Use this to add a new client to your database. It automates the onboarding of new business accounts. ### create_debit_note Create a debit note. Use this to issue specific billing adjustments. It helps you correct errors on previous invoices. ### create_product Create a product. Use this to add new items to your inventory catalog. It makes expanding your product line easy. ### create_simplified_purchase Create a simplified purchase invoice. This helps you record B2C transactions quickly. It keeps your records organized. ### create_vat_invoice Create a B2B VAT invoice. It ensures your business-to-business sales meet all tax requirements. This automates your tax compliance. ### delete_customer Delete a customer. Use this to remove old client records from your database. It helps keep your contact list clean. ### get_customer Get customer details. Use this to pull specific information for a client. It's useful for quick lookups. ### list_invoices List invoices. This gives you a full view of all your recent billing history. It's helpful for tracking monthly revenue. ### list_products List products. Use this to see every item currently in your catalog. It helps you manage your entire inventory. ### create_simplified_invoice Create a B2C invoice. Use this for everyday retail sales to keep things simple. It's great for high-volume transactions. ### create_standard_purchase Create a standard purchase invoice. This is the go-to for standard purchase documentation. It maintains consistent billing records. ### delete_product Delete a product. Use this to remove items that are no longer in your catalog. It keeps your inventory list accurate. ### get_invoice Get invoice details. This helps you find specific billing records quickly. It's great for auditing past sales. ### list_customers List customers. Use this to see a full directory of your current clients. It provides a clear view of your customer base. ### update_customer Update a customer. Use this to edit contact info or tax registration numbers. It keeps your client data current. ### update_product Update a product. Use this to change prices or details for your inventory. It's the easiest way to manage stock updates. ### validate_api_key Validate API key. Use this to check if your connection to SimpleFatoora is active. It ensures your integration stays online. ### get_product Get product details. Use this to check the current price or description of an item. It helps with inventory management. ## Prompt Examples **Prompt:** ``` Create a B2B VAT invoice for a client who bought 5 laptops at 5000 SAR each. ``` **Response:** ``` I've generated the B2B VAT invoice for your client. **Order Summary:** | Item | Quantity | Unit Price | Total | | :--- | :--- | :--- | :--- | | Laptop | 5 | 5,000 SAR | 25,000 SAR | **Total Amount:** 25,000 SAR (VAT Included) ✅ The invoice is now ZATCA-compliant and includes the required cryptographic stamp and QR code. Would you like me to send the PDF to the client? ``` **Prompt:** ``` List our customers who have a VAT registration number. ``` **Response:** ``` I've pulled your customer list. Here are the clients with active VAT registrations: * **Al-Futtaim Trading** (VAT: 300000000000001) * **Saudi Retail Group** (VAT: 300000000000002) * **Gulf Logistics** (VAT: 300000000000003) Total: 3 customers found. ``` **Prompt:** ``` Issue a credit note for invoice 998 because of a damaged item. ``` **Response:** ``` I've created a credit note for invoice #998. **Adjustment Details:** * **Reason:** Damaged Item * **Status:** ZATCA Compliant * **Stamp:** Verified The credit has been linked to the original invoice and the customer's balance has been updated. Do you need me to send a confirmation email to the customer? ``` ## Capabilities ### Generate ZATCA-compliant invoices Your agent can create B2B, B2C, and purchase invoices that meet all Saudi tax requirements. ### Issue credit and debit notes Automatically generate and stamp credit or debit notes for returns and adjustments. ### Update product and customer records Manage your entire inventory catalog and client database through direct AI commands. ### Validate tax compliance Verify that your billing data and API connections meet local regulatory standards. ### Check API connectivity Instantly verify your connection to the SimpleFatoora platform is active and healthy. ## Use Cases ### Issuing a B2B invoice A finance manager needs to bill a client. They ask the agent to create a B2B VAT invoice using create_vat_invoice. ### Handling a product return A customer returns an item. The agent uses create_credit_note to issue the refund and link it to the original bill. ### Updating a price list A shop owner changes prices for the season. The agent uses update_product to refresh the entire catalog. ### Onboarding a new client A new business signs up. The agent uses create_customer to set up their profile and tax ID. ## Benefits - Automate ZATCA compliance. Use create_vat_invoice to ensure every B2B sale meets Saudi tax laws without manual checks. - Manage inventory faster. Use list_products and update_product to keep your catalog current in seconds. - Simplify customer records. Use create_customer and update_customer to maintain a clean database of your clients. - Handle returns easily. Use create_credit_note to issue refunds that are automatically stamped for compliance. - Audit billing history. Use list_invoices and get_invoice to pull specific records for your accounting team. - Verify system health. Use validate_api_key and check_simplefatoora_status to keep your integration running without surprises. ## How It Works The bottom line is you get automated, compliant Saudi e-invoicing without the manual data entry. 1. Subscribe to the SimpleFatoora MCP in the Vinkius catalog. 2. Provide your SimpleFatoora API key from your developer dashboard. 3. Ask your AI agent to create invoices, update products, or pull customer lists. ## Frequently Asked Questions **Does SimpleFatoora support ZATCA Phase 2 compliance?** Yes, this Connector is specifically designed to meet ZATCA Phase 2 requirements. It handles the necessary cryptographic stamping and tax compliance for your invoices automatically. **Can I use SimpleFatoora for both B2B and B2C invoices?** Absolutely. You can use it to generate B2B VAT invoices, B2C simplified invoices, and standard purchase invoices all through your AI agent. **How does SimpleFatoora handle credit notes?** It automatically creates and stamps credit notes for returns or adjustments. This ensures your records stay compliant with local tax laws while keeping your customer balance accurate. **Can I manage my product catalog through the AI?** Yes, you can use your agent to list products, update prices, or add new items to your catalog instantly without manual data entry. **Is SimpleFatoora good for Saudi tax compliance?** It's built specifically for it. It manages VAT rates, customer tax IDs, and compliant invoice generation to keep your Saudi business in good standing. **Can I update customer details automatically?** Yes, your agent can update customer contact information, tax registration numbers, and other profiles to keep your database current and accurate. **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.