Mcp Flow Cl

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

MCP server for Flow.cl — Chilean PSP: hosted payment orders, Webpay, refunds, HMAC-signed API

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

概覽

AI 產生的概覽

針對智利支付服務商 Flow.cl 的本機 MCP 伺服器，讓助理建立代管付款訂單、查詢付款狀態並辦理退款。

可以做什麼
建立代管付款訂單並取得客戶付款用的付款連結，或讓 Flow 寄送收款連結郵件給客戶。依 Flow token、商家訂單編號或 Flow 訂單編號查詢付款狀態。依日期分頁列出已收到的付款。建立全額或部分退款訂單，並查詢退款狀態。
適用情境
適合讓助理協助智利商家透過 Flow 收款，例如為訂單產生付款連結、核對哪些訂單已付款，或發起退款，而不必手寫帶簽章的 API 呼叫。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-flow-cl 在本機執行，需要 Node.js。需要 Flow 商家帳戶及 API 金鑰與簽章金鑰，分別以 FLOW_API_KEY 和 FLOW_SECRET_KEY 設定。FLOW_ENV 選擇 sandbox（預設）或 production，沙箱環境會核發自己的金鑰組。需要連線至 Flow API 的網路。
安裝前請注意
此伺服器持有可建立付款與退款的商家憑證；FLOW_SECRET_KEY 用於簽署每個請求，應妥善保密。將 FLOW_ENV 設為 production 會涉及真實資金並實際退款，建議先在沙箱測試。建立付款與退款會變更 Flow 帳戶中的資料。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-flow-cl

MCP server for Flow (flow.cl) — the Chile-native PSP: one hosted payment order covers Webpay (credit/debit), ETpay bank transfer, cash networks and international cards. Refunds included. Every API call is HMAC-SHA256 signed.

[npm] [License: MIT]

Quick Start

Claude Desktop

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

json
{  "mcpServers": {    "flow-cl": {      "command": "npx",      "args": ["-y", "@codespar/mcp-flow-cl"],      "env": {        "FLOW_API_KEY": "your-flow-api-key",        "FLOW_SECRET_KEY": "your-flow-secret-key",        "FLOW_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add flow-cl --env FLOW_API_KEY=... --env FLOW_SECRET_KEY=... -- npx -y @codespar/mcp-flow-cl

Cursor / VS Code

Add the same block to .cursor/mcp.json or .vscode/mcp.json.

Tools (8)

ToolEndpointWhat it does
create_paymentPOST /payment/createHosted payment order; returns url + token the customer pays at
create_payment_by_emailPOST /payment/createEmailFlow emails the customer a collection link
get_payment_statusGET /payment/getStatusStatus by Flow token (1 pending, 2 paid, 3 rejected, 4 canceled)
get_payment_status_by_commerce_idGET /payment/getStatusByCommerceIdStatus by your commerceOrder
get_payment_status_by_flow_orderGET /payment/getStatusByFlowOrderStatus by Flow order number
list_paymentsGET /payment/getPaymentsPayments received on a date (paged)
create_refundPOST /refund/createFull or partial refund order
get_refund_statusGET /refund/getStatusRefund status by refund token

Authentication

Flow signs every request: parameters are sorted alphabetically, concatenated as name+value, and signed with HMAC-SHA256 using your secretKey. This server does the signing for you — set the two env vars and call tools with plain arguments.

VariableRequiredDescription
FLOW_API_KEYyesFlow merchant API key
FLOW_SECRET_KEYyesHMAC signing secret (never sent on the wire)
FLOW_ENVnosandbox (default) or production

Sandbox: register at sandbox.flow.cl — the sandbox issues its own key pair.

Example

"Create a Flow payment order for CLP 25,000, subject 'Plan Pro mensual', email [email protected], and give me the payment link."

The agent calls create_payment and returns url?token=... — the customer picks Webpay, ETpay or cash at Flow's hosted page.

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.

Managed tier

This open-source server calls Flow's API directly with your credentials. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, governance, audit and a credential vault: codespar.dev/agents.

License

MIT

來源：packages/payments/flow-cl/README.md，提交 d0a519a

工具

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

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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