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 在拉美的发卡业务：创建持卡人、发行虚拟或实体卡、变更卡状态并查询交易。

可以做什么
把 Pomelo 发卡 API 封装为九个工具：create_user、get_user、update_user 管理持卡人身份；create_card、get_card、list_cards、update_card_status 用于虚拟或实体 Visa/Mastercard 的发行与生命周期变更；list_transactions、get_transaction 查询交易流水。它使用 OAuth2 客户端凭证认证，自动换取并缓存 Bearer 令牌，并在写操作中附带幂等键。
适用场景
当助手需要协助运营 Pomelo 在阿根廷、巴西、墨西哥、哥伦比亚、秘鲁或智利的卡项目时适用，例如录入持卡人、发卡或冻结卡、查询交易。它不用于实时授权决策，那由你自行托管的 webhook 处理。
运行要求
以 npm 包形式通过 npx 在本地运行（需要 Node.js），在桌面版 MCP 客户端中配置。需要 POMELO_CLIENT_ID 和 POMELO_CLIENT_SECRET；POMELO_ENV 选择 sandbox（默认）或 production，POMELO_BASE_URL、POMELO_AUTH_URL、POMELO_AUDIENCE 可覆盖默认值。需要访问 Pomelo 的 API 与认证端点。
安装前请注意
该服务器持有可访问真实卡项目的 OAuth2 客户端凭证（POMELO_CLIENT_ID、POMELO_CLIENT_SECRET），不要放入共享配置。工具会写入：创建用户和卡、变更卡状态；POMELO_ENV=production 时操作的是真实卡与持卡人。这些工具不会返回完整卡号与 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 分