# Facturama (SAT) MCP for AI Agents AI Agent Connect > Facturama (SAT) MCP automates Mexican CFDI 4.0 tax invoices. It lets your AI client issue formal invoices, pull recently emitted records, and manage tax catalogs directly with the SAT backend. Stop manual data entry for Mexican tax compliance and let your agent handle the bureaucracy. ## Overview - **Category:** government-public-data - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_5XGdL1GzThJPG90cYlQPmPZNfm3iC9WuP8WVG60k/ai-agent-connect - **Tags:** tax-compliance, invoicing, cfdi, mexico-tax, ledger-management, electronic-receipts ## Description Handling Mexican tax compliance is a headache. Between managing RFC values, checking SAT statuses, and pulling down XML files for every transaction, it's a lot of clicking and copy-pasting. This Connector changes that by putting the Facturama backend directly into your AI's hands. Instead of navigating a clunky UI, you just tell your agent what to do. You can have it issue a real invoice for a verified client or grab a specific product's tax details without leaving your chat window. It handles the heavy lifting of the CFDI 4.0 requirements so you can focus on actually running the business. Because Vinkius hosts this, you can connect it to your existing setup and start automating your accounting loops in minutes. It's about moving from manual data entry to natural language commands for your Mexican fiscal receipts. ## Tools ### list_invoices List all issued CFDIs and tax invoices. Use this to see your recent activity and verify successful submissions. ### create_client Register a new B2B invoice receiver in the system. This helps you keep your client database updated without manual entry. ### delete_client Remove a client's context from your records. Use this to clean up old or incorrect receiver data. ### get_tax_status Read the internal SAT compliance tax state for a specific record. It ensures you know your current standing. ### list_catalog Scan all standard SAT codes to find the right product. This prevents using incorrect government tax codes. ### list_taxes Read internal schema tax profiles to ensure accuracy. This helps you understand the tax rules for your items. ### send_invoice_email Push an issued invoice via your local mailer. It automates the delivery of receipts to your customers. ### cancel_invoice Cancel an issued CFDI or tax invoice. This is useful for correcting errors or processing returns. ### create_invoice Issue a formal digital tax invoice (CFDI) with correct values. It handles the official submission to the backend. ### get_client Get a specific client's fiscal profile. Use this to verify RFC details before you start a new transaction. ### get_invoice_file Extract an invoice graphic representation as a Base64 file. It lets you grab the actual PDF content instantly. ### get_product Fetch targeted product SAT specifics from the catalog. It gives you the exact data needed for compliant billing. ### list_clients List all registered clients along with their tax details (RFC). This is great for quick audits of your customer base. ### list_products List all tax-mapped registered products in your inventory. It helps you see what is currently available for sale. ## Prompt Examples **Prompt:** ``` Find all invoices we sent to Agencia Global S.A. last week. ``` **Response:** ``` Searching your Facturama records... I found 2 invoices issued last week for Agencia Global S.A. (RFC: AGE120092B08): | Folio | Date | Amount | Status | | :--- | :--- | :--- | :--- | | 001 | Oct 24 | $1,200.00 | Issued | | 002 | Oct 26 | $450.00 | Issued | Both have been successfully stamped by the SAT. ``` **Prompt:** ``` I need to register a new client. Their name is 'Tech Solutions' and their RFC is 'TS123456789'. ``` **Response:** ``` I've registered the new client for you. **New Client Details:** * **Name:** Tech Solutions * **RFC:** TS123456789 * **Status:** Active You can now use this client for future CFDI issuances. ``` **Prompt:** ``` What is the correct SAT code for a 'Commercial Laptop'? ``` **Response:** ``` I've scanned the official SAT catalog. Here are the matching codes for a 'Commercial Laptop': * **Code:** 521115 * **Description:** Equipo de cómputo para uso comercial * **Tax Category:** General Would you like me to use this code for your next invoice? ``` ## Capabilities ### Issue formal CFDI invoices Tell your agent to create a legal Mexican tax invoice with correct RFC and product data. ### Pull recent invoice history Get a full list of issued and pending CFDIs tied to your SAT account. ### Fetch verified product tax codes Look up the correct government-validated codes for your inventory items. ### Register new B2B clients Add new receiver profiles to your system using their fiscal information. ### Download invoice files as Base64 Retrieve graphic representations of invoices for sharing or storage. ### Check internal SAT compliance status Verify the current tax standing and compliance state of your records. ## Use Cases ### The Audit Headache An accountant needs to find all invoices for a specific month. They ask the agent to list_invoices and filter by date. ### The New Client A salesperson just closed a deal. They tell the agent to create_client using the new company's RFC. ### The Missing PDF A customer lost their receipt. The operator tells the agent to get_invoice_file to send a new copy. ### The Product Check A dev needs to know the tax code for a new item. They ask the agent to list_products and find the ID. ## Benefits - Stop hunting for XML files by using get_invoice_file to pull records instantly. - Ensure 100% compliance by using list_catalog to pick the correct SAT codes every time. - Speed up onboarding with create_client to register new B2B partners in seconds. - Automate your ledger by using list_invoices to get a full history of issued receipts. - Reduce errors in billing by using get_client to pull verified RFC tags before sending. ## How It Works The bottom line is you get a natural language interface for Mexican tax compliance. 1. Add the Connector to your client and enter your Facturama API credentials. 2. Provide your basic auth configuration in the private base64 stream. 3. Start asking your agent to issue invoices or check tax statuses. ## Frequently Asked Questions **Can Facturama (SAT) MCP handle Mexican CFDI 4.0?** Yes, this Connector is specifically built to automate Mexican CFDI 4.0 invoices, ensuring your receipts meet all current government requirements. **How do I use Facturama (SAT) MCP to issue invoices?** You simply tell your agent to issue an invoice for a specific product and client. It will handle the data retrieval and submission automatically. **Can Facturama (SAT) MCP find my lost receipts?** Yes, you can ask your agent to retrieve any specific invoice, and it will pull the graphic representation for you to view or share. **Does Facturama (SAT) MCP work with other AI clients?** Yes, because it is hosted on Vinkius, you can connect it to Claude, Cursor, Windsurf, or any other MCP-compatible client. **Is Facturama (SAT) MCP good for high-volume eCommerce?** It's ideal for high-volume work because it removes the manual steps of looking up tax codes and RFCs for every single sale. **Can I bulk cancel tax invoices directly on the Mexican IRS bypassing visual interfaces?** Yes. Utilize the `cancel_invoice` target tool carefully giving it the unique CFDI ID alongside the formal SAT motive parameter representing your reasoning, and it actively invalidates the fiscal stamp instantly at source. **How securely does the Basic Authentication hold within Vurb handling the Mexican invoices?** The variables act as deep protected MCP credentials. You input them once securely mapping directly to fields labeled with generic `sensitive: true`. They transform cleanly into masked Base64 encodings locally and disappear off visual UI radar guaranteeing no accidental token logging into public clouds. **Can I retrieve a raw representation like PDF base64 of an older CFDI directly via Claude text generation?** Absolutely. Deploy `get_invoice_file` referencing the exact entity ID while choosing between XML or PDF format outputs, granting heavy duty tracking across any calendar timeline seamlessly.