Mcp Nequi

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.0-alpha.3更新於 Oct 24, 2026

Nequi — Colombian digital wallet (50M+ users, by Bancolombia)

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

針對哥倫比亞數位錢包 Nequi 的本機 MCP 伺服器，讓助理建立付款、QR code 與訂閱，並查詢餘額與結算。

可以做什麼
建立與排程推播付款、產生 QR code 付款與商家靜態 QR code，並通知未註冊收款人領取款項。查詢付款狀態、驗證手機號碼、列出商家交易，並取得帳戶餘額、商家資料與結算資料。沖正付款與交易，並取得或取消訂閱。授權針對 Nequi 使用者的週期性扣款協議。
適用情境
當助理需要處理哥倫比亞的 Nequi 商家付款時使用：收款或預約付款、產生 QR code、查看餘額與結算，或處理退款與訂閱。目前為早期 alpha 版本，適合評估與沙箱測試，而非無人值守的正式環境使用。
執行需求
以 npm 套件形式透過 stdio 在本機執行，需要 Node.js；也可選用 HTTP 模式。需要 Nequi 開發者帳戶與三個環境變數：NEQUI_API_KEY、NEQUI_CLIENT_ID 和 NEQUI_CLIENT_SECRET。選用的 NEQUI_ENV 可選擇沙箱或正式環境，預設為沙箱。需要連線至 Nequi API 的網路存取。
安裝前請注意
涉及真實資金：工具可發起付款、預約未來付款、授權週期性扣款、沖正交易與取消訂閱，出錯會造成資金變動。README 說明這是 alpha 版本，介面路徑尚未完全經過實際驗證；應固定精確版本並先在沙箱測試。需要三個憑證，包括機密的 NEQUI_API_KEY 與 NEQUI_CLIENT_SECRET，應避免出現在日誌與共用設定中。將 NEQUI_ENV 設為正式環境會指向真實資金

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Nequi，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

MCP Nequi

Alpha release — published under the alpha npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during 0.x.x-alpha. Install with npm install <pkg>@alpha.

MCP server for Nequi — Colombia's leading digital wallet with 50M+ users, powered by Bancolombia. Supports push payments, QR payments, and subscriptions.

Quick Start

bash
# Set your credentialsexport NEQUI_API_KEY="your-api-key"export NEQUI_CLIENT_ID="your-client-id"export NEQUI_CLIENT_SECRET="your-client-secret"
# Run via stdionpx tsx packages/colombia/nequi/src/index.ts
# Run via HTTPnpx tsx packages/colombia/nequi/src/index.ts --http

Environment Variables

VariableRequiredDescription
NEQUI_API_KEYYesAPI key from Nequi developer portal
NEQUI_CLIENT_IDYesOAuth2 client ID
NEQUI_CLIENT_SECRETYesOAuth2 client secret
NEQUI_ENVNo"sandbox" or "production" (default: sandbox)
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (16)

ToolPurpose
create_push_paymentSend a push payment notification to a Nequi user
get_payment_statusCheck the status of a payment
create_qr_paymentGenerate a QR code for payment
reverse_paymentReverse a completed payment
get_subscriptionGet subscription details for a phone number
unsubscribeCancel a subscription
create_static_qrGenerate a static (reusable) Nequi QR code for a merchant
reverse_transactionReverse any Nequi transaction by transaction ID (refund flow)
validate_phoneCheck whether a phone number is enrolled in Nequi
notify_unregistered_paymentNotify a non-Nequi recipient with instructions to claim a payment
list_transactionsList transactions for a merchant within a date range
get_balanceGet the merchant's own Nequi account balance
schedule_paymentSchedule a Nequi push payment for a future date
authorize_recurring_chargeAuthorize a recurring charge agreement against a Nequi user
get_merchant_infoRetrieve registered merchant business profile
get_settlementQuery settlement (liquidation) for a given date

Auth

Uses OAuth2 client credentials flow. The server obtains an access token using client ID and secret, and includes the API key in every request header.

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:

  • NEQUI_API_KEY (required, secret) — API key for Nequi
  • NEQUI_CLIENT_ID (required) — OAuth2 client ID
  • NEQUI_CLIENT_SECRET (required, secret) — OAuth2 client secret

Issue credentials at the provider's developer portal: https://api.nequi.com.co.

License

MIT

來源：packages/colombia/nequi/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0-alpha.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分