Mcp Pomelo

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

MCP server for Pomelo — pan-LATAM card issuing: users, virtual/physical cards, transactions

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

概覽

AI 產生的概覽

Pomelo 發卡服務的 MCP 伺服器：讓助理建立持卡人、發行虛擬或實體卡、變更卡片狀態並查詢交易。

可以做什麼
  • 建立、查詢與更新持卡人使用者
  • 發行虛擬或實體卡，依 ID 或依使用者、狀態查詢卡片
  • 變更卡片生命週期狀態（啟用、凍結、停用）
  • 檢索卡片交易流水並查詢單筆交易
  • 寫入操作會自動附上冪等鍵，也可在單次呼叫中自行指定
適用情境
適合在拉丁美洲經營 Pomelo 卡專案時使用，讓助理在對話中完成持卡人開戶、發卡或凍結卡片，以及查詢卡片與交易紀錄。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-pomelo 在本機執行（需 Node.js）。需要 OAuth2 用戶端憑證 POMELO_CLIENT_ID 與 POMELO_CLIENT_SECRET；POMELO_ENV 選擇 sandbox（預設）或 production，POMELO_BASE_URL、POMELO_AUTH_URL、POMELO_AUDIENCE 可覆寫預設值。需能連線至 Pomelo 的 API。
安裝前請注意
此憑證具備真實發卡權限：當 POMELO_ENV 設為 production 時，助理可建立使用者、發卡以及凍結或停用卡片，會影響真實持卡人與資金。建議先在預設的 sandbox 環境測試，並妥善保管 POMELO_CLIENT_ID 與 POMELO_CLIENT_SECRET。這些工具不會回傳完整卡號與 CVV。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-pomelo

MCP server for Pomelo — pan-LATAM card issuing as a service: card-holder users, virtual and physical Visa/Mastercard issuance, lifecycle management, and the transactions feed. Argentina, Brazil, Mexico, Colombia, Peru, Chile.

[npm] [License: MIT]

Quick Start

Claude Desktop

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

json
{  "mcpServers": {    "pomelo": {      "command": "npx",      "args": ["-y", "@codespar/mcp-pomelo"],      "env": {        "POMELO_CLIENT_ID": "your-client-id",        "POMELO_CLIENT_SECRET": "your-client-secret",        "POMELO_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add pomelo -- npx @codespar/mcp-pomelo

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "pomelo": {      "command": "npx",      "args": ["-y", "@codespar/mcp-pomelo"],      "env": {        "POMELO_CLIENT_ID": "your-client-id",        "POMELO_CLIENT_SECRET": "your-client-secret",        "POMELO_ENV": "sandbox"      }    }  }}

Environment

VariableRequiredDescription
POMELO_CLIENT_IDyesOAuth2 client id
POMELO_CLIENT_SECRETyesOAuth2 client secret
POMELO_ENVnosandbox (default) or production
POMELO_BASE_URLnoAPI base override (default https://api-stage.pomelo.la in sandbox, https://api.pomelo.la in production)
POMELO_AUTH_URLnoAuth base override; the token call is {AUTH_URL}/oauth/token (default: the same host as the API, per Pomelo's docs)
POMELO_AUDIENCEnoOAuth2 audience override (defaults per env)

Authentication is OAuth2 client-credentials; the server exchanges and caches the Bearer token automatically.

Tools (9)

ToolWhat it does
create_userCreate a card-holder identity (POST /users/v1)
get_userFetch a user by id
update_userPatch user fields (status, contact, address)
create_cardIssue a VIRTUAL or PHYSICAL card (POST /cards/v1)
get_cardFetch a card (masked PAN, status, program)
list_cardsList cards, filterable by user/status
update_card_statusACTIVE / BLOCKED / DISABLED lifecycle changes
list_transactionsSearch the card-transactions feed
get_transactionFetch one transaction by id

Mutating calls carry an x-idempotency-key (auto-generated, overridable per call via idempotency_key).

Example

"Issue a virtual card for the new contractor and freeze the old one."

The agent calls create_user (if needed) → create_card (card_type: "VIRTUAL") → update_card_status (status: "BLOCKED", status_reason: "CLIENT_INTERNAL_REASON").

Notes

  • Card credentials (full PAN/CVV) are never returned by these tools; Pomelo exposes sensitive data only through its PCI-scoped widgets.
  • Authorization decisioning (approving each swipe in real time) is a webhook you host, not an API call — pair this server with CodeSpar's governed authorizer if you want mandate checks per transaction.

Authentication

OAuth2 client-credentials: the server exchanges POMELO_CLIENT_ID / POMELO_CLIENT_SECRET for a Bearer token at {AUTH_URL}/oauth/token and caches it until shortly before expiry. Mutating calls carry an x-idempotency-key.

Enterprise

Need governance, budget limits, and audit trails for agent-driven card issuing on Pomelo? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/banking/pomelo/README.md，提交 d0a519a

工具

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

版本歷史

2
  1. v0.1.1最新Sep 27, 2026
  2. v0.1.0Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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