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 產生的概覽

本機 MCP 伺服器，讓助理執行 Celcoin 銀行服務操作：Pix 收款與退款、boleto 開立與付款、轉帳、餘額、對帳單和儲值。

可以做什麼
  • 建立和查詢 Pix 收款，包含即時（cob）與到期（cobv）收款及 QR code，以及 Pix 付款和退款
  • 解析 Pix DICT 金鑰，回傳帳戶持有人與銀行資訊
  • 開立、查詢和取消 boleto，並先授權再支付條碼帳單
  • 建立 TED/DOC 轉帳，依 ISPB 代碼列出巴西銀行
  • 查詢帳戶餘額和指定日期區間的對帳單
  • 列出電信儲值服務商並建立手機或服務儲值
適用情境
適合讓助理透過 Celcoin 處理巴西付款流程，例如開立 Pix 收款、依條碼支付帳單、發起轉帳或查詢餘額與對帳單，特別適合在 Celcoin 沙箱中測試時使用。
執行需求
透過 npx 從 npm 套版本機執行，需要 Node.js。需要 Celcoin 開發者帳號和 OAuth2 憑證，放在 CELCOIN_CLIENT_ID 與 CELCOIN_CLIENT_SECRET 中；CELCOIN_SANDBOX=true 使用沙箱，CELCOIN_BASE_URL 可覆寫主機。正式環境呼叫需要 mTLS 和預先登記的 IP，因此需要代理。
安裝前請注意
這些工具會動用真實資金：轉帳、帳單付款、Pix 退款和儲值一經確認通常無法撤銷。憑證屬於機密，不應外流。正式環境要求 Celcoin 簽發的憑證和已登記 IP 的 mTLS，本伺服器不提供用戶端憑證，直接呼叫正式環境會失敗；應將 CELCOIN_BASE_URL 指向負責終止 mTLS 的代理。請先在沙箱中測試。

安裝

在 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 分