How to Use the Facturama (SAT) MCP in Claude Code

Q: How do I add the Facturama (SAT) MCP Server to Claude Code?

Run the command claude mcp add --transport http facturama-sat-mcp -- in your terminal. You can verify the installation by running claude mcp list to see the 14 available tools.

Q: Can I cancel incorrect invoices directly from my terminal?

Yes. You can run a quick command in Claude Code to execute cancelinvoice, allowing you to legally void incorrect CFDIs with the SAT without opening a browser or logging into a web portal.

Automate your Mexican tax compliance directly from the command line using Claude Code and the Facturama (SAT) MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Facturama (SAT) MCP to Claude Code

Create your Vinkius account to connect Facturama (SAT) to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Facturama (SAT) with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

CLI-Driven CFDI Management via MCP Server

Claude Code brings headless execution to your Mexican tax workflows. From your terminal, you can issue commands to generate CFDIs without a browser, using `create_invoice` to submit tax data directly to the SAT through Facturama's API. This terminal-first approach lets you pipe outputs from `list_invoices` into other CLI utilities like grep or jq. You can quickly filter transactions, check tax statuses, and manage your financial records with standard shell commands.

Headless Compliance and Tax Audits

Running compliance checks in a headless environment is straightforward with this MCP Server. Claude Code can run cron jobs that call `get_tax_status` and `list_taxes` to ensure your system is aligned with current SAT regulations. If the agent detects an issue, it can query `list_catalog` to find the correct product codes and output a report directly to your terminal. This makes it easy to monitor tax compliance within your existing server infrastructure.

Scriptable Client and Catalog Sync

Automate your B2B client management using shell scripts and terminal commands. Claude Code can execute `create_client` to register new tax profiles and `delete_client` to purge outdated records without manual data entry. By calling `list_products` and `get_product`, your terminal agent can keep your local product database perfectly synced with SAT tax mappings. You can run these sync routines as part of your deployment pipelines or nightly maintenance scripts.

Setup guide

Set up Facturama (SAT) MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see facturama-sat-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Facturama (SAT) transactions." It will automatically discover and invoke the available Facturama (SAT) tools.

Terminal

claude mcp add --transport http facturama-sat-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Facturama (SAT) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "facturama-sat-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Facturama (SAT Mexico). 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Facturama (SAT) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Facturama (SAT) MCP in Claude Code

Run the command `claude mcp add --transport http facturama-sat-mcp -- ` in your terminal. You can verify the installation by running `claude mcp list` to see the 14 available tools.

Yes, this terminal client is built for headless environments. You can script Claude Code to execute `create_invoice` and `send_invoice_email` as part of automated billing runs in your deployment pipelines.

Ask Claude Code to retrieve an invoice, and it will execute `get_invoice_file` to pull the Base64 data. The terminal agent can then write that data directly to a local PDF or XML file in your current directory.

Yes. You can run a quick command in Claude Code to execute `cancel_invoice`, allowing you to legally void incorrect CFDIs with the SAT without opening a browser or logging into a web portal.

Your credentials are saved locally in your terminal configuration files (~/.claude.json) and are passed securely through the Vinkius sandbox. Your CFDI payloads, RFC numbers, and client tax records are never exposed to external servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript