Mcp Picpay

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

MCP server for PicPay Business — BR digital wallet (60M+ users): checkout, Pix QR, subscriptions

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

概覽

AI 產生的概覽

針對 PicPay Business 的在地 MCP 伺服器，讓助理建立與管理巴西數位錢包的付款、Pix QR 碼、付款連結、訂閱與轉帳。

可以做什麼
建立與管理結帳付款：建立付款、依參考號查詢狀態、取消、退款（可部分退款），並依日期範圍列出商家交易。產生 Pix 風格 QR 碼（靜態或帶固定金額與到期時間的動態碼）以及可分享的付款連結。管理訂閱方案：建立、列出、更新、刪除方案，並為買家登記、查詢或取消訂閱。資金轉出：建立企業對個人（B2P）轉帳、查詢轉帳狀態、批次送出轉帳。查詢商家錢包的巴西雷亞爾餘額，並以賣家權杖驗證傳入的 webhook 回呼。
適用情境
適合讓助理操作 PicPay Business 商家帳戶的情境：收款、產生 Pix QR 碼或付款連結、經營訂閱、付款給 PicPay 使用者，或核對交易與餘額。較適合將 PicPay 結帳整合進代理工作流程的開發者，而非一般終端使用者。
執行需求
透過 npm 套件 @codespar/mcp-picpay 以 stdio 在本機執行（需要 Node.js）；另有選用的 HTTP 模式供伺服器間測試。需要 PicPay 商家整合權杖（PICPAY_TOKEN）與賣家權杖（PICPAY_SELLER_TOKEN）。PICPAY_BASE_URL 為選用，預設指向公開的電商 API。需要連線至 PicPay 的網路。
安裝前請注意
涉及真實資金：轉帳、批次付款、退款、取消與刪除方案會移動或改變資金，無法隨意復原。兩個權杖都是商家憑證，會以請求標頭送出，應避免寫入日誌或共用設定。信任 webhook 內容前應先以賣家權杖驗證。此套件為 alpha 版本，訂閱相關端點的欄位層級結構尚未與線上 API 確認。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-picpay

MCP server for PicPay Business — Brazilian digital wallet with 60M+ users.

PicPay's Checkout API lets merchants create a payment intent that the buyer completes inside the PicPay app, returning a redirect URL plus a Pix-style QR code. The Recurrency API adds subscription plans on top.

Tools (20)

ToolPurpose
create_paymentCreate a PicPay checkout payment.
get_payment_statusGet the status of a payment by referenceId.
cancel_paymentCancel a PicPay order.
create_planCreate a subscription plan (Recurrency API).
list_plansList all subscription plans registered for this merchant.
update_planUpdate an existing subscription plan.
delete_planDelete a subscription plan.
create_subscriptionEnroll a buyer in a subscription plan.
get_subscriptionRetrieve a subscription by id.
cancel_subscriptionCancel an active subscription.
validate_notificationVerify that an incoming webhook callback came from PicPay by comparing the x-seller-token header against PI...
refund_paymentRefund a paid PicPay order, optionally partially.
create_b2p_transferCreate a Business-to-Person (B2P) transfer: push funds from the merchant wallet to a PicPay user identified...
get_b2p_transferGet the status of a B2P transfer by referenceId.
create_batch_paymentSubmit a batch of B2P transfers in a single request.
list_transactionsList merchant transactions (payments and transfers) within a date range.
get_wallet_balanceRetrieve the merchant's current PicPay wallet balance (available and blocked amounts in BRL).
generate_static_qrcodeGenerate a static PicPay Pay QR code for in-store / reusable use.
generate_dynamic_qrcodeGenerate a dynamic PicPay Pay QR code with a fixed amount and optional expiration.
create_payment_linkCreate a shareable PicPay payment link.

Install

bash
npm install @codespar/mcp-picpay@alpha

Environment

bash
PICPAY_TOKEN="..."          # Merchant integration token (x-picpay-token header)PICPAY_SELLER_TOKEN="..."   # Seller token used to validate webhook callbacksPICPAY_BASE_URL="..."       # Optional. Defaults to https://appws.picpay.com/ecommerce/public

Authentication

Every request sends:

Content-Type: application/jsonx-picpay-token: <PICPAY_TOKEN>

PicPay webhook callbacks carry x-seller-token: <PICPAY_SELLER_TOKEN>. Use the validate_notification tool (or compare the header yourself) before trusting a payload, then fetch the authoritative status with get_payment_status.

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-picpay
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-picpay

Status

0.1.0-alpha.1. Core checkout endpoints (/payments, /payments/{ref}/status, /payments/{ref}/cancellations) are verified against PicPay's public docs. Recurrency (plans + subscriptions) endpoints come from the documented path shape but field-level schemas (frequency enum values, subscription response) should be confirmed against the live API before production use.

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/picpay/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 分