Mcp Celcoin

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

MCP server for Celcoin — Pix, boleto, transfers, bill payments, top-ups

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

概览

AI 生成的概览

让助手操作 Celcoin 巴西银行服务：Pix 收款与退款、boleto、账单支付、转账、充值以及余额查询。

可以做什么
将 Celcoin 的 BaaS API 封装为 18 个工具，涵盖 Pix 支付、即时与到期 Pix 收款（cob/cobv）、DICT 键查询、devolução 退款、boleto 开具与取消、条码读取与账单支付、TED/DOC 转账、对账单、余额、银行列表以及电信充值。它自动处理 OAuth2 客户端凭证认证与令牌刷新，并提供沙箱模式用于测试。
适用场景
当助手需要通过 Celcoin 创建或查询巴西支付业务时使用，例如开具 Pix 收款、支付 boleto、发起转账或查询余额，且你已持有 Celcoin 凭证。建议先在沙箱中测试。
运行要求
通过 npx 从 npm 包 @codespar/mcp-celcoin 在本地运行，需要 Node.js。需要 Celcoin 开发者账号和 OAuth2 凭证，以 CELCOIN_CLIENT_ID 和 CELCOIN_CLIENT_SECRET 提供；CELCOIN_SANDBOX 与 CELCOIN_BASE_URL 为可选项。需要访问 Celcoin API 的网络连接。
安装前请注意
该服务器可操作真实资金：创建 Pix 支付与收款、支付账单、开具 boleto、发起转账与充值，以及退款 Pix 交易。CELCOIN_CLIENT_SECRET 是有效凭证，不应放入共享配置。生产调用需要 Celcoin 签发的证书进行 mTLS，并仅限预先注册的 IP；本服务器不提供客户端证书，因此生产环境须通过 CELCOIN_BASE_URL 指向代理。测试时请使用 CELCOIN_SANDBOX。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-celcoin

MCP server for Celcoin — BaaS infrastructure for Pix, boleto, transfers, and top-ups

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "celcoin": {      "command": "npx",      "args": ["-y", "@codespar/mcp-celcoin"],      "env": {        "CELCOIN_CLIENT_ID": "your-client-id",        "CELCOIN_CLIENT_SECRET": "your-client-secret",        "CELCOIN_SANDBOX": "true"      }    }  }}

Claude Code

bash
claude mcp add celcoin -- npx @codespar/mcp-celcoin

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "celcoin": {      "command": "npx",      "args": ["-y", "@codespar/mcp-celcoin"],      "env": {        "CELCOIN_CLIENT_ID": "your-client-id",        "CELCOIN_CLIENT_SECRET": "your-client-secret",        "CELCOIN_SANDBOX": "true"      }    }  }}

Tools (18)

ToolPurpose
create_pix_paymentCreate a Pix payment via Celcoin
get_pix_paymentGet Pix payment details by transaction ID
create_pix_cobCreate a Pix immediate charge (cob) — generates QR code / copia-e-cola for payer
get_pix_cobGet a Pix immediate charge by transactionId or txid
create_pix_cobvCreate a Pix due charge (cobv) — boleto-like Pix with due date
lookup_pix_dictLookup a Pix DICT key — resolves a Pix key to account holder + bank info
create_pix_devolutionCreate a Pix devolução (refund) — refund a received Pix transaction
cancel_boletoCancel a boleto issued via the bill-issuance product by id
read_barcodeAuthorize (consult) a boleto / concessionária barcode before paying — returns transactionId, amount, totalUpdated, dueDate
pay_billConfirm payment of a previously authorized bill — pass the read_barcode transactionId as transactionIdAuthorize
get_statementGet account statement (extrato) for a date range
list_topup_providersList telecom top-up providers (operadoras) available for recargas
create_boletoIssue a boleto via the bill-issuance product
get_boletoGet an issued boleto's details by id
create_transferCreate a bank transfer (TED/DOC) via Celcoin
get_balanceGet account balance at Celcoin
list_banksList available banks in Brazil (ISPB codes)
create_topupCreate a mobile/service top-up (recarga) via Celcoin

Authentication

Celcoin uses OAuth2 client credentials. The server automatically manages token refresh.

Sandbox / Testing

Celcoin provides a sandbox at sandbox.openfinance.celcoin.dev. Set CELCOIN_SANDBOX=true to use it.

Without CELCOIN_SANDBOX, the server calls Celcoin production at api.openfinance.celcoin.com.br (up to 0.2.3 the default was api-sec.celcoin.com.br, a host that does not exist). Celcoin accepts production calls only over mTLS, with a certificate Celcoin issues, and only from IPs you registered with them in advance (Celcoin docs). From any other IP the token call answers 401 "O seu IP ou certificado digital nao foi reconhecido". This server does not present a client certificate, so in production point CELCOIN_BASE_URL at a proxy that holds the certificate and terminates the mTLS; called directly, production answers that 401.

Get your credentials

  1. Go to Celcoin Documentation
  2. Create a developer account
  3. Register an application to get OAuth2 credentials
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
CELCOIN_CLIENT_IDYesOAuth2 client ID
CELCOIN_CLIENT_SECRETYesOAuth2 client secret
CELCOIN_SANDBOXNoSet to "true" for sandbox mode
CELCOIN_BASE_URLNoOverride the API host. Defaults: https://api.openfinance.celcoin.com.br (production), https://sandbox.openfinance.celcoin.dev (sandbox)

Roadmap

v0.2 (planned)

  • get_pix_key — Get Pix key details (DICT lookup)
  • create_bill_payment — Create a bill/utility payment
  • get_bill_payment — Get bill payment details
  • create_scheduled_transfer — Create a scheduled transfer
  • list_providers — List available service providers

v0.3 (planned)

  • batch_topups — Process multiple mobile top-ups
  • detailed_reports — Generate detailed transaction reports

Want to contribute? Open a PR or request a tool.

Links

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.

License

MIT

来源：packages/payments/celcoin/README.md，提交 d0a519a

工具

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

版本历史

2
  1. v0.2.4最新Sep 27, 2026
  2. v0.2.3Sep 16, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

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

  • 已声明认证方式10 分

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

  • 已列出工具15 分

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

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