Mcp Facturapi

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

FacturAPI — Mexican CFDI e-invoicing

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向墨西哥 CFDI 电子发票平台 FacturAPI 的本地 MCP 服务器，让助手创建、查询、取消和邮件发送发票，并管理客户与产品。

可以做什么
创建、查询、列出和取消 CFDI 发票，获取发票的 PDF 或 XML 下载链接，并把发票邮件发送给客户或指定收件人。创建、读取、列出、更新和删除用于开票的客户。创建、读取、列出、更新和删除用于开票的产品。创建和列出销售收据（客户之后可凭收据自行开票），以及列出已配置的 webhook。
适用场景
适合让助手端到端处理墨西哥 CFDI 开票事务：开具或取消发票、通过邮件发送发票，并让客户和产品记录与 FacturAPI 保持同步。
运行要求
以本地进程方式运行，npm 包 @codespar/mcp-facturapi，使用 stdio 传输（文档也提到 HTTP 模式）。需要 FacturAPI 账户，并通过环境变量 FACTURAPI_API_KEY 提供 API 密钥，同时需要访问 FacturAPI 服务的网络连接。
安装前请注意
FACTURAPI_API_KEY 中的 API 密钥属于机密，对账户具有计费和税务层面的权限。相关工具会创建、更新、删除和取消记录；取消发票或向客户发送发票会产生实际的法律与商业后果。README 还提到面向代理支付治理的企业版附加组件，与本服务器相互独立。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Facturapi，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

MCP FacturAPI

MCP server for FacturAPI — Mexican CFDI e-invoicing platform (equivalent to Brazil's NFe).

Quick Start

bash
# Set your API keyexport FACTURAPI_API_KEY="sk_..."
# Run via stdionpx tsx packages/mexico/facturapi/src/index.ts
# Run via HTTPnpx tsx packages/mexico/facturapi/src/index.ts --http

Environment Variables

VariableRequiredDescription
FACTURAPI_API_KEYYesAPI key from FacturAPI dashboard
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (20)

ToolPurpose
create_invoiceCreate a CFDI invoice
get_invoiceGet invoice by ID
list_invoicesList invoices with filters
cancel_invoiceCancel an invoice
download_invoice_pdfDownload invoice as PDF (returns download URL)
download_invoice_xmlDownload invoice as XML (returns download URL)
send_invoice_emailSend invoice (PDF + XML) by email to the customer or to specific recipients
create_customerCreate a customer for invoicing
get_customerGet customer by ID
list_customersList customers with optional filters
update_customerUpdate an existing customer (partial update)
delete_customerDelete a customer
create_productCreate a product for invoicing
get_productGet product by ID
list_productsList products
update_productUpdate an existing product (partial update)
delete_productDelete a product
create_receiptCreate a receipt (recibo de venta) — the customer can later self-invoice it from the receipt's folio
list_receiptsList receipts with filters
list_webhooksList configured webhooks

Auth

Uses Bearer token authentication. Obtain your API key from the FacturAPI Dashboard.

API Reference

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

  • FACTURAPI_API_KEY (required, secret) — API key for FacturAPI

Issue credentials at the provider's developer portal: https://docs.facturapi.io.

License

MIT

来源：packages/mexico/facturapi/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分