mcp-pomelo

@codespar/mcp-pomelo

面向 Pomelo 的 MCP 服务——泛拉美地区的卡片发行即服务：持卡人用户、Visa/Mastercard 虚拟卡和实体卡发行、生命周期管理，以及交易动态。覆盖阿根廷、巴西、墨西哥、哥伦比亚、秘鲁、智利。

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.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

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

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.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"
      }
    }
  }
}

环境变量

变量	必需	描述
POMELO_CLIENT_ID	是	OAuth2 客户端 ID
POMELO_CLIENT_SECRET	是	OAuth2 客户端密钥
POMELO_ENV	否	sandbox（默认）或 production
POMELO_BASE_URL	否	API 基础 URL 覆盖值（默认值：沙盒环境为 https://api-stage.pomelo.la，生产环境为 https://api.pomelo.la）
POMELO_AUTH_URL	否	身份验证基础 URL 覆盖值；令牌请求地址为 {AUTH_URL}/oauth/token（默认值：根据 Pomelo 文档，与 API 使用相同主机）
POMELO_AUDIENCE	否	OAuth2 受众覆盖值（默认为对应环境的值）

使用 OAuth2 客户端凭据进行身份验证；服务会自动获取并缓存 Bearer 令牌。

工具（9 个）

工具	功能
create_user	创建持卡人身份（POST /users/v1）
get_user	按 ID 获取用户
update_user	更新用户字段（状态、联系方式、地址）
create_card	发行 VIRTUAL 或 PHYSICAL 卡（POST /cards/v1）
get_card	获取卡片信息（屏蔽后的 PAN、状态、计划）
list_cards	列出卡片，可按用户/状态筛选
update_card_status	更改生命周期状态：ACTIVE / BLOCKED / DISABLED
list_transactions	搜索卡片交易动态
get_transaction	按 ID 获取一笔交易

写入调用会携带 x-idempotency-key（自动生成，也可通过每次调用的 idempotency_key 覆盖）。

示例

“为新承包商发行一张虚拟卡，并冻结旧卡。”

Agent 会调用 create_user（如有需要）→ create_card（card_type: "VIRTUAL"）→ update_card_status（status: "BLOCKED"、status_reason: "CLIENT_INTERNAL_REASON"）。

说明

• 这些工具绝不会返回卡片凭据（完整 PAN/CVV）；Pomelo 仅通过其 PCI 范围内的小组件公开敏感数据。
• 授权决策（实时批准每笔刷卡交易）通过由你托管的 Webhook 实现，而非 API 调用。如果你希望针对每笔交易检查授权规则，请将此服务与 CodeSpar 的受治理授权器搭配使用。

身份验证

OAuth2 客户端凭据：服务会通过 {AUTH_URL}/oauth/token 使用 POMELO_CLIENT_ID / POMELO_CLIENT_SECRET 获取 Bearer 令牌，并在令牌即将过期前将其缓存。写入调用会携带 x-idempotency-key。

企业版

需要为由 Agent 驱动的 Pomelo 卡片发行提供治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、支付路由和合规模板。

许可证

MIT