Mcp Wompi

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

Wompi — Colombian payment gateway (by Bancolombia)

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

概覽

AI 產生的概覽

針對 Wompi（Bancolombia 旗下哥倫比亞支付閘道）的 MCP 伺服器，讓助理建立與管理交易、付款連結、退款與客戶。

可以做什麼
  • 建立、查詢、列出、依商戶參考號搜尋以及作廢付款交易
  • 建立、更新與列出付款連結，並列出可用的付款方式
  • 將信用卡與 Nequi 錢包權杖化、查詢權杖化狀態，並建立可重複使用的付款來源
  • 建立與查詢客戶、列出 PSE 銀行，並取得商戶資訊
  • 建立與查詢退款，並驗證 Wompi 事件（webhook）簽章
適用情境
適合需要處理哥倫比亞 Wompi 付款的情境：建置或測試結帳流程、辦理退款、管理付款連結與客戶，或在對話中查詢交易狀態。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-wompi 在本機執行（需要 Node.js）。需要 WOMPI_PUBLIC_KEY 與 WOMPI_PRIVATE_KEY，可選用 WOMPI_EVENTS_SECRET 驗證 webhook 簽章。可選 WOMPI_SANDBOX 以及 MCP_HTTP/MCP_PORT 切換沙箱或 HTTP 傳輸。憑證需在 Wompi 開發者入口申請。
安裝前請注意
私鑰（WOMPI_PRIVATE_KEY）與事件密鑰（WOMPI_EVENTS_SECRET）屬敏感憑證，可授權真實付款操作。工具可建立交易、付款連結、付款來源、退款與客戶，並可作廢交易，會涉及真實資金與客戶資料。信用卡與 Nequi 錢包的權杖化會把付款資訊傳送給 Wompi。建議先以沙箱模式測試，再使用正式憑證。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-wompi

MCP server for Wompi, the Colombian payment gateway by Bancolombia, supporting cards, PSE bank transfers, Nequi, and Bancolombia transfers

[npm] [License: MIT]

Quick Start

bash
# Set your credentialsexport WOMPI_PUBLIC_KEY="pub_test_..."export WOMPI_PRIVATE_KEY="prv_test_..."export WOMPI_SANDBOX="true"
# Run via stdionpx -y @codespar/mcp-wompi
# Run via HTTPMCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-wompi

Environment Variables

VariableRequiredDescription
WOMPI_PUBLIC_KEYYesPublic key from Wompi dashboard
WOMPI_PRIVATE_KEYYesPrivate key for server-side operations
WOMPI_SANDBOXNoSet to "true" for sandbox environment
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (22)

ToolPurpose
create_transactionCreate a payment transaction
get_transactionGet transaction details by ID
list_transactionsList transactions
search_transaction_by_referenceFind transaction(s) by merchant reference
void_transactionVoid a transaction
create_payment_linkCreate a payment link
get_payment_linkGet payment link details
update_payment_linkUpdate a payment link
list_payment_linksList payment links
list_payment_methodsList available payment methods for the merchant
get_acceptance_tokenGet merchant acceptance token (required for transactions)
create_tokenized_cardTokenize a credit/debit card
create_tokenized_nequiTokenize a Nequi wallet (start async tokenization by phone number)
get_tokenization_statusQuery async tokenization status (Nequi etc.) by tokenization id
create_payment_sourceCreate a reusable payment source (CARD/NEQUI/PSE) linked to a customer email
create_customerCreate a customer profile
get_customerGet customer by ID
list_financial_institutionsList PSE banks (financial institutions)
create_refundCreate a refund for a transaction
get_refundGet refund details by ID
get_merchantGet merchant information
validate_webhook_signatureValidate a Wompi event signature.

Auth

Uses Bearer token authentication with the private key. The public key is used for client-side tokenization and merchant queries.

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:

  • WOMPI_PUBLIC_KEY (required) — Public key for Wompi
  • WOMPI_PRIVATE_KEY (required, secret) — Private key for Wompi
  • WOMPI_EVENTS_SECRET (secret) — Events/webhook secret for signature validation

Issue credentials at the provider's developer portal: https://docs.wompi.co.

License

MIT

來源：packages/colombia/wompi/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 分