mcpField
M
MCP Dev Brasil — 37 Servers for Agentic Commerce

MCP Dev Brasil — 37 Servers for Agentic Commerce

本地服务
github.com/codesparAI 与智能体2754 周前更新

关于 MCP Dev Brasil — 37 Servers for Agentic Commerce

面向巴西商业 Agent 的 MCP 服务集合,覆盖支付轨道及税务、银行、通信、物流、ERP、身份和加密服务。目录也包含 Stripe ACP 等协议,帮助 Agent 通过 MCP 工具连接商业 API。

主要功能

  1. 01覆盖巴西商业服务类别
  2. 02连接多种支付服务与 Stripe ACP
  3. 03涵盖税务、银行和加密 API
  4. 04支持物流、通信及 ERP 工作流
  5. 05提供 stdio 和 Streamable HTTP

适用场景

  1. 01使用 Pix 收款并处理商业订单
  2. 02付款后开具 NFe 或 NFSe
  3. 03发送物流追踪信息并更新 ERP
  4. 04通过 MCP 调用巴西服务接口

MCP 相关

提供封装巴西供应商 API 的 MCP 服务和工具,并包含 Stripe ACP 等协议服务;支持 stdio 与 Streamable HTTP。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"dev-brasil": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-brasil-api"
]
}
}
}
启动命令npx -y @codespar/mcp-brasil-api

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@codespar/mcp-brasil-api

工具

15

收录的工具列表 · 更新于 2 周前

参数类型必填说明
cepstring是CEP(8 位数字,例如 01001000)

详细介绍

MCP Dev LATAM 🌎

你的 AI Agent 在拉丁美洲开展业务所需的每一个商务 API。
巴西 🇧🇷 · 墨西哥 🇲🇽 · 阿根廷 🇦🇷 · 哥伦比亚 🇨🇴 · 智利 🇨🇱 · 秘鲁 🇵🇪 · 外加 4 种 Agent 支付协议。

面向 LATAM 商务的 MCP 服务 · 已在官方 MCP Registry 上线 · MIT 许可证

机器可读目录:codespar.dev/api/servers

目录 · 快速开始 · Agent 协议 · 所有服务 · 参与贡献

License: MIT Live in the official MCP Registry 6 countries MCP compatible


问题所在

AI Agent 可以编写代码、分析数据、聊天。但它们无法经营业务——收款、开具发票、发货或通知客户。在拉丁美洲尤其如此,这里的每项服务都有自己的 API、认证模式和各种怪癖(BACEN Pix v2 使用 mTLS,STP-SPEI 使用 JWT-RSA,AFIP Web 服务,受合同限制的开发者门户,等等)。

与此同时,四种 Agent 支付协议正在并行推出——结账协议(Stripe ACP、Google UCP)、授权层(AP2)以及微支付通道(x402)——而它们之间,以及与企业实际运行的区域支付通道之间,都无法干净地组合。

MCP Dev LATAM 弥合了这两道鸿沟。 传统 LATAM 服务 + 新型 Agent 支付协议,全部可通过单一的 MCP 接口访问。

解决方案

本仓库中的每个 MCP 服务都封装了一个真实的服务提供商——支付、财税、物流、消息、银行、ERP、身份、反欺诈、加密货币以及 Agent 协议——让你的 Agent 能够运转一套完整的企业工作流。

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

六套系统。零人工干预。一个 Agent。


Agentic 支付协议

面向新兴 Agentic 支付技术栈的四个服务。目前只有 Stripe ACP 连接到可用的线上服务;其余三个已废弃(参见表格下方的说明):

协议服务工具功能
Google UCP 已废弃:无可用端点@codespar/mcp-ucp20Universal Commerce Protocol——Agentic 购物、购物车、结账、订单、配送、身份。
Stripe ACP@codespar/mcp-stripe-acp24Agentic Commerce Protocol——AI Agent 结账、支付委托、商品、发票。
x402 已废弃:无可用端点@codespar/mcp-x40210Coinbase 提供的 HTTP 原生小额支付——当 Agent 遇到 402 时,会在 Base/Solana 上支付 USDC 并重试。纯 HTTP,无结账 UI。
AP2 已废弃:无可用端点@codespar/mcp-ap2 alpha22Google 的 Agent-to-Agent Payment Protocol——授权、审计追踪、限定范围的支出限额。

UCP、AP2 和 x402 已废弃:无可用端点。 测量于 2026-09-27:

服务默认主机该主机的应答
@codespar/mcp-ucpcommerce.googleapis.com(沙盒:sandbox.commerce.googleapis.com)HTTP 404,返回 Google 的通用 Error 404 (Not Found) 页面;沙盒主机的 TLS 握手失败(证书属于 *.googleapis.com)
@codespar/mcp-ap2ap2.googleapis.com(沙盒:sandbox.ap2.googleapis.com)同样的通用 404 页面;沙盒主机以同样的方式 TLS 握手失败
@codespar/mcp-x402api.x402.org在 DNS 中无法解析(8.8.8.8 和 1.1.1.1)

仅凭一个通用 404 并不能证明某个名称背后没有服务:translate.googleapis.com/v1 是一个已注册的服务,在被请求一个它不提供的路径时,也会返回同样的页面。这一结论的依据是:这些服务调用的每个路径都以同样的方式失败。UCP 和 AP2 是开放规范,而非 Google 托管的 API,x402 也没有中心化 API(每个卖方自行选择其 facilitator)。这三个包已在 npm 上废弃,此处保留仅供参阅;它们已从下方的快速开始和决策树中移除。另有八个服务因同样的原因(其默认主机无法解析)而废弃:C6、Dock、Matera、Legiti、Caf、Certta、Unico 和 Nubank。

自主性谱系

每个协议处于不同的 Agent 自主性层级:

 Human-in-loop ◄──────────────────────────────► Fully autonomous

  ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
  │   ACP   │   │   UCP   │   │   AP2   │   │   x402  │
  │ Stripe  │   │ Google  │   │ Google  │   │Coinbase │
  └─────────┘   └─────────┘   └─────────┘   └─────────┘
  User confirms   Commerce     User sets      No user.
  every purchase  lifecycle    rules, agent   Machine-to-
  in-chat         managed      acts within    machine at
                  by agent     budget/scope   HTTP layer
融合技术栈
┌─────────────────────────────────────────────┐
│  Application Layer        ACP / UCP         │  Chat UX, product discovery
├─────────────────────────────────────────────┤
│  Authorization Layer      AP2 / Mandates    │  Spend limits, audit trails
├─────────────────────────────────────────────┤
│  Tool Layer               MCP  ◄── WE ARE  │  Standardized agent tools
├─────────────────────────────────────────────┤
│  Settlement Layer         x402 / Pix / Card │  On-chain or traditional rails
└─────────────────────────────────────────────┘

MCP Dev LATAM 位于工具层——通过一个接口连接所有应用、授权和结算协议的中间件。

为何重要
Agent needs to buy something
  ├── Retail checkout?     → Stripe ACP (create_checkout → complete_checkout)
  └── LATAM merchant?      → Asaas / Mercado Pago / Conekta / Wompi / etc.

All via MCP. Same interface. One agent.

快速开始

使用 Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "stripe-acp": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stripe-acp"],
      "env": {
        "STRIPE_API_KEY": "sk_test_..."
      }
    },
    "asaas": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-asaas"],
      "env": {
        "ASAAS_API_KEY": "your-api-key",
        "ASAAS_SANDBOX": "true"
      }
    }
  }
}

对于 alpha 包(受合同限制的提供商,如 Itaú、Bradesco、Santander、Caixa、BB、BTG、Sicoob),在安装时添加 @alpha:

npx -y @codespar/mcp-itau@alpha
使用任意 MCP 客户端
npx @codespar/mcp-stripe-acp        # Agentic Commerce Protocol

npx @codespar/mcp-asaas              # BR billing + Pix
npx @codespar/mcp-mercado-pago       # LATAM payments
npx @codespar/mcp-nuvem-fiscal       # NFe / NFSe
npx @codespar/mcp-melhor-envio       # Multi-carrier shipping
npx @codespar/mcp-z-api              # WhatsApp messaging
npx @codespar/mcp-omie               # ERP
npx @codespar/mcp-stark-bank         # Banking
npx @codespar/mcp-brasil-api         # CEP, CNPJ (no key needed!)
立即试用(无需 API 密钥)

BrasilAPI 和 BCRA 是公开的——无需密钥。在终端中试用:

npx @codespar/mcp-brasil-api

然后问你的 Agent:"CEP 01001-000 的地址是什么?" 或 "查询 CNPJ 00.000.000/0001-91"。

将服务指向其他主机

每个服务都从环境变量中读取其提供商主机,因此可以在不发布新版本的情况下使用代理、模拟服务或提供商迁移后的端点。主要 API 是 <PREFIX>_BASE_URL,其中 <PREFIX> 是该服务凭据已使用的那个(CELCOIN_BASE_URL、STONE_BASE_URL、BB_BASE_URL)。第二个主机使用 <PREFIX>_<ROLE>_URL,例如用于令牌端点的 STONE_AUTH_URL 或 CIELO_QUERY_URL。当变量未设置时,服务会使用其文档中记录的默认值。

每周一次的 CI 任务(catalog-hosts.yml)会解析目录中的每个默认主机并与其完成 TLS 握手,当某个主机不存在时任务会失败。唯一的例外是已弃用的服务和列出的少数沙箱主机,每项都在 scripts/catalog-hosts-known-dead.json 中附有原因;当其中某一项恢复时该任务也会失败,因此该列表不会过期。使用 python3 scripts/check-catalog-hosts.py 在本地运行它(Python 3.10+)。


完整闭环

这正是 LATAM 目录与众不同之处——不是单个连接器,而是跨垂直领域的完整业务工作流:

步骤垂直领域示例提供商Agent 做什么
1💳 支付Asaas / Mercado Pago / Zoop创建 Pix 收款,拆分给卖家
2📄 财税Nuvem Fiscal / NFe.io / Focus NFe在支付确认后开具 NFe/NFSe
3📦 物流Melhor Envio / Correios / Skydropx计算运费报价,生成面单
4📱 消息传递Z-API / WhatsApp Cloud / Twilio通过客户偏好的渠道发送物流跟踪信息
5📊 ERPOmie / Bling / Tiny / Conta Azul记录订单,更新库存
6🏦 银行Stark Bank / Itaú / BTG核对余额,生成报表

要借助治理、审批工作流和审计追踪来编排全部六个步骤——请使用 CodeSpar。


所有服务

在 codespar.dev/servers 浏览完整目录。每个服务都在 packages/<category>/<slug>/ 下有自己的 README、环境变量要求和工具参考。

💳 支付(46 个服务)
服务工具npm认证
Rinne62@codespar/mcp-rinneAPI Key
Mercado Pago30@codespar/mcp-mercado-pagoAPI Key
Stripe30@codespar/mcp-stripeAPI Key
Zoop28@codespar/mcp-zoopAPI Key
Adyen25@codespar/mcp-adyenAPI Key
Asaas24@codespar/mcp-asaasAPI Key
Pagseguro24@codespar/mcp-pagseguroAPI Key
Stripe ACP24@codespar/mcp-stripe-acpAPI Key
Iugu23@codespar/mcp-iuguAPI Key
Openpay23@codespar/mcp-openpayAPI Key
AP2 alpha deprecated: no live endpoint22@codespar/mcp-ap2API Key
Braintree22@codespar/mcp-braintreeAPI Key
Braspag22@codespar/mcp-braspagAPI Key
Cielo22@codespar/mcp-cieloAPI Key
Inter Bank22@codespar/mcp-inter-bankOAuth2
Mercado Libre22@codespar/mcp-mercado-libreAPI Key
Nubank alpha deprecated: no live endpoint22@codespar/mcp-nubankOAuth2
Nupay22@codespar/mcp-nupayOAuth2
Pagar Me22@codespar/mcp-pagar-meAPI Key
Rapyd22@codespar/mcp-rapydAPI Key
Rede alpha22@codespar/mcp-redeAPI Key
Safrapay alpha22@codespar/mcp-safrapayOAuth2
Worldpay alpha22@codespar/mcp-worldpayAPI Key
Khipu alpha21@codespar/mcp-khipuAPI Key
Stone21@codespar/mcp-stoneAPI Key
Malga24@codespar/mcp-malgaAPI Key
Wise21@codespar/mcp-wiseAPI Key
Airwallex20@codespar/mcp-airwallexOAuth2
Culqi20@codespar/mcp-culqiAPI Key
Getnet20@codespar/mcp-getnetOAuth2
Izipay alpha20@codespar/mcp-izipayAPI Key
Picpay alpha20@codespar/mcp-picpayAPI Key
UCP deprecated: no live endpoint20@codespar/mcp-ucpAPI Key
Vindi20@codespar/mcp-vindiAPI Key
Paypal19@codespar/mcp-paypalOAuth2
Transbank alpha19@codespar/mcp-transbankAPI Key
Celcoin18@codespar/mcp-celcoinAPI Key
dLocal18@codespar/mcp-dlocalAPI Key
Ebanx18@codespar/mcp-ebanxAPI Key
Efi18@codespar/mcp-efiAPI Key
Pix BCB18@codespar/mcp-pix-bcbAPI Key
Chargebee15@codespar/mcp-chargebeeAPI Key
Kushki10@codespar/mcp-kushkiAPI Key
Flow.cl8@codespar/mcp-flow-clAPI Key
Niubiz4@codespar/mcp-niubizUser/Password
PagBrasil3@codespar/mcp-pagbrasilAPI Key
🏦 Banking (16 servers)
ServerToolsnpmAuth
Stark Bank27@codespar/mcp-stark-bankAPI Key
Caixa alpha23@codespar/mcp-caixaOAuth2
Santander alpha23@codespar/mcp-santanderOAuth2
Bradesco alpha22@codespar/mcp-bradescoOAuth2
Itau alpha22@codespar/mcp-itauOAuth2
Matera alpha deprecated: no live endpoint22@codespar/mcp-materaOAuth2
Dock alpha deprecated: no live endpoint20@codespar/mcp-dockOAuth2
Open Finance18@codespar/mcp-open-financeAPI Key
Pluggy16@codespar/mcp-pluggyAPI Key
C6 alpha deprecated: no live endpoint14@codespar/mcp-c6OAuth2
Banco Do Brasil alpha13@codespar/mcp-banco-do-brasilOAuth2
Sicoob alpha13@codespar/mcp-sicoobOAuth2
BTG alpha12@codespar/mcp-btgOAuth2
Iniciador9@codespar/mcp-iniciadorAPI Key
Pomelo9@codespar/mcp-pomeloOAuth2
Midaz5@codespar/mcp-midazAPI Key (optional)
📄 Fiscal (Brasil) (4 servers)
ServerToolsnpmAuth
Nuvem Fiscal24@codespar/mcp-nuvem-fiscalAPI Key
Nfe Io22@codespar/mcp-nfe-ioAPI Key
Conta Azul20@codespar/mcp-conta-azulAPI Key
Focus Nfe19@codespar/mcp-focus-nfeAPI Key
📱 Communication (8 servers)
ServerToolsnpmAuth
Z API27@codespar/mcp-z-apiAPI Key
Evolution API25@codespar/mcp-evolution-apiAPI Key
Twilio22@codespar/mcp-twilioAPI Key
Whatsapp Cloud22@codespar/mcp-whatsapp-cloudAPI Key
Sendgrid20@codespar/mcp-sendgridAPI Key
Rd Station18@codespar/mcp-rd-stationAPI Key
Take Blip18@codespar/mcp-take-blipAPI Key
Zenvia18@codespar/mcp-zenviaAPI Key
📦 E-commerce / Logistics (7 servers)
ServerToolsnpmAuth
Vtex33@codespar/mcp-vtexAPI Key
Shopify28@codespar/mcp-shopifyAPI Key
Amazon alpha24@codespar/mcp-amazonOAuth2
Shopee alpha22@codespar/mcp-shopeeAPI Key
Correios alpha21@codespar/mcp-correiosAPI Key
Melhor Envio18@codespar/mcp-melhor-envioAPI Key
SuperFrete11@codespar/mcp-superfreteAPI Key
📊 ERP / 会计(5 个服务)
服务工具npm认证
Omie30@codespar/mcp-omieAPI Key
Bling28@codespar/mcp-blingAPI Key
Xero24@codespar/mcp-xeroAPI Key
Quickbooks22@codespar/mcp-quickbooksAPI Key
Tiny21@codespar/mcp-tinyAPI Key
🪪 身份与 KYC(8 个服务)
服务工具npm认证
Brasil API24@codespar/mcp-brasil-api无需认证
Jumio20@codespar/mcp-jumioAPI Key
Onfido20@codespar/mcp-onfidoAPI Key
Persona20@codespar/mcp-personaAPI Key
Unico alpha deprecated: no live endpoint18@codespar/mcp-unicoOAuth2
Certta deprecated: no live endpoint11@codespar/mcp-certtaAPI Key
BigDataCorp10@codespar/mcp-bigdatacorpAPI Key
Caf deprecated: no live endpoint9@codespar/mcp-cafAPI Key
🛡️ 欺诈与风险(4 个服务)
服务工具npm认证
Sift alpha20@codespar/mcp-siftAPI Key
Clearsale alpha18@codespar/mcp-clearsaleAPI Key
Konduto alpha18@codespar/mcp-kondutoAPI Key
Legiti alpha deprecated: no live endpoint18@codespar/mcp-legitiAPI Key
🪙 加密货币 / 稳定币(10 个服务)
服务工具npm认证
Circle23@codespar/mcp-circleAPI Key
Foxbit21@codespar/mcp-foxbitAPI Key
Bitso20@codespar/mcp-bitsoAPI Key
Mercado Bitcoin20@codespar/mcp-mercado-bitcoinAPI Key
Moonpay20@codespar/mcp-moonpayAPI Key
Unblockpay13@codespar/mcp-unblockpayAPI Key
Coinbase Commerce18@codespar/mcp-coinbase-commerceAPI Key
Transak alpha18@codespar/mcp-transakAPI Key
Coinbase CDP15@codespar/mcp-coinbase-cdpAPI Key
x402 deprecated: no live endpoint10@codespar/mcp-x402API Key
🇦🇷 阿根廷(6 个服务)
服务工具npm认证
Tienda Nube24@codespar/mcp-tienda-nubeAPI Key
Colppy alpha22@codespar/mcp-colppyAPI Key
AFIP alpha20@codespar/mcp-afipAPI Key
Andreani alpha18@codespar/mcp-andreaniAPI Key
BCRA16@codespar/mcp-bcra无需认证
Payway6@codespar/mcp-paywayAPI Key
🇨🇴 哥伦比亚 (8 个服务)
服务工具npm认证
Siigo22@codespar/mcp-siigoAPI Key
Wompi22@codespar/mcp-wompiAPI Key
Alegra20@codespar/mcp-alegraAPI Key
Coordinadora alpha19@codespar/mcp-coordinadoraAPI Key
Nequi alpha16@codespar/mcp-nequiOAuth2
Cobre8@codespar/mcp-cobreAPI Key
ePayco8@codespar/mcp-epaycoAPI Key
Bold7@codespar/mcp-bold-coAPI Key
🇲🇽 墨西哥 (7 个服务)
服务工具npm认证
Belvo24@codespar/mcp-belvoAPI Key
Skydropx23@codespar/mcp-skydropxAPI Key
Conekta21@codespar/mcp-conektaAPI Key
Bind ERP20@codespar/mcp-bind-erpAPI Key
Facturapi20@codespar/mcp-facturapiAPI Key
STP/SPEI alpha18@codespar/mcp-stp-speiAPI Key
Clip6@codespar/mcp-clipAPI Key

为什么选择 MCP?

Model Context Protocol 是连接 AI Agent 与外部工具的开放标准。与其让每个 Agent 各自构建集成,MCP 提供了一个类型化、可发现的接口,可与 Claude、ChatGPT、Cursor、VS Code 等配合使用。

AI Agent (Claude, ChatGPT, Cursor)
    ↕
MCP Server (this repo)
    ↕
LATAM API / Agentic Protocol (Stripe ACP, x402, Asaas, Mercado Pago, NFe.io, etc.)

本仓库中的每个 MCP 服务:

  • 暴露带输入/输出 schema 的类型化工具
  • 处理认证(OAuth、mTLS、API key、Basic Auth、JWT-RSA、签名请求)
  • 支持双传输 — stdio(默认)和 Streamable HTTP(--http 标志)
  • 通过 MCP Connector 兼容 Claude Managed Agents
  • 支持沙箱模式,便于安全测试
  • 返回结构化 JSON 响应
以 HTTP 模式运行

任何服务都可以作为 HTTP 服务运行,用于远程/云端场景:

# stdio (default — local, Claude Desktop, Cursor, Claude Code)
npx @codespar/mcp-asaas

# HTTP (remote — Managed Agents, cloud deployments)
npx @codespar/mcp-asaas --http
# or
MCP_HTTP=true npx @codespar/mcp-asaas

HTTP 模式暴露 /mcp(Streamable HTTP)和 /health(状态检查)。


Alpha 与 stable

目录中约三分之一的内容以 alpha npm dist-tag 发布。这些包的工具 schema 和认证流程正确,但端点路径属于最佳猜测——通常是因为提供方的开发者门户受合同限制(巴西的公共银行、阿根廷的中央机构 API、墨西哥的银行转账提供方)。它们在源码中以 TODO(verify) 标记。

npm install @codespar/mcp-itau@alpha

Stable 包(占大多数)使用默认 tag 安装:

npm install @codespar/mcp-stripe

状态显示在每个包的页面 codespar.dev/servers 以及各包的 README 中。


关于 CodeSpar

CodeSpar 为拉丁美洲的 AI Agent 构建商业基础设施——包括一个 MCP 目录(本仓库)、一个运行时 + SDK(npm 上的 @codespar/sdk,PyPI 上的 codespar),以及一个托管层治理产品(AgentGate:可编程钱包、策略引擎、CFO 级审计、财税合规认证)。

单个 MCP 服务很有用。用治理来编排多个服务则威力强大。 这正是 CodeSpar 所做的。

隶属于一个更广泛的生态索引:Awesome Agentic Commerce LATAM —— 一份供应商中立的清单,涵盖拉丁美洲资金流转 Agent 所涉及的协议、通道、提供方和监管。


贡献

我们欢迎贡献。请参阅 CONTRIBUTING.md。

想要一个未列出的服务的服务? 提交一个服务请求 issue —— 有一个结构化表单,包含名称、npm 包、文档链接、认证流程。

许可证

MIT —— 可在商业和开源项目中自由使用。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。