mcpField
T
Toss Payments

Toss Payments

本地服务
appmonster.co.kr金融数据06 天前更新
代码仓库访问官网

关于 Toss Payments

Toss Payments 是用于访问 Toss Payments 核心操作的 MCP 服务，涵盖支付查询、交易列表和结算，也支持取消与退款，并为写操作提供人工审批选项。

主要功能

  1. 01查询支付详情
  2. 02列出已批准和已取消的交易
  3. 03读取结算金额和费用
  4. 04取消支付或部分退款

适用场景

  1. 01按 paymentKey 或 orderId 查询支付
  2. 02核对指定日期范围内的交易
  3. 03查看结算费用和付款金额
  4. 04在取消支付前请求审批

MCP 相关

向 MCP 客户端提供 Toss Payments 查询、交易、结算和取消工具。取消操作可使用确认令牌，或通过 OK Agent 进行审批。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "groove79-mcp-toss-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-toss-payments"
      ],
      "env": {
        "TOSS_SECRET_KEY": "<TOSS_SECRET_KEY>",
        "OKAGENT_API_KEY": "<OKAGENT_API_KEY>",
        "KMCP_WRITE_MODE": "<KMCP_WRITE_MODE>"
      }
    }
  }
}
启动命令npx -y @appmonster/mcp-toss-payments
需要配置的环境变量
TOSS_SECRET_KEY密钥Secret key (test_sk_… or live_sk_…) from the Toss Payments developer center
OKAGENT_API_KEY密钥OK Agent key (free at okagent.kr) — writes then wait for your OK on KakaoTalk. Unset: writes ask for confirmation in the chat first.
KMCP_WRITE_MODEapproval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@appmonster/mcp-toss-payments0.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@appmonster/mcp-toss-payments

用于 Toss Payments（토스페이먼츠）核心 API 的 MCP 服务。Agent 可以查询支付、核对交易、读取结算信息，也可以取消支付或退款。后者是唯一会实际转移资金的工具，因此设计为在人工审批后运行（OK Agent）。

Toss Payments MCP 服务——查询支付、交易记录、结算以及取消／退款（审批门控）。

工具

工具访问权限功能
toss_get_payment读取通过 paymentKey 或 orderId 查询一笔支付：状态、金额、余额、方式、取消记录和收据 URL
toss_cancel_payment写入全额／部分取消。虚拟账户支付必须提供退款账户。自动添加 Idempotency-Key
toss_list_transactions读取按日期范围列出交易（批准、取消），最多 5000 笔，使用 startingAfter 游标
toss_list_settlements读取结算记录（手续费、增值税、支付金额），按销售日期／支付日期筛选，包含合计

设置

  1. 前往 https://developers.tosspayments.com → 我的开发信息 → API 密钥。请先使用以 test_sk_… 开头的密钥（使用测试支付数据）。
  2. MCP 客户端配置：
{
  "mcpServers": {
    "toss-payments": {
      "command": "npx",
      "args": ["-y", "@appmonster/mcp-toss-payments"],
      "env": { "TOSS_SECRET_KEY": "test_sk_…" }
    }
  }
}
取消操作的人工审批（使用正式密钥时强烈建议）
"OKAGENT_API_KEY": "ok_…"

即使未启用此功能，写入工具也绝不会在未经确认的情况下运行：首次调用会返回预览和 confirm_token，Agent 只有在你于聊天中同意后才会再次调用。使用 OK Agent 密钥（免费，每月 200 次）后，请求会改为发送到你的手机，并附带日志；你可以通过 KakaoTalk 批准。KMCP_WRITE_MODE=direct 会关闭检查，适用于你完全信任的脚本。

使用 live_sk_ 密钥时，如果未配置审批钩子，服务启动时会打印警告。

安全说明

  • toss_cancel_payment 操作不可逆。工具描述会要求 Agent 先调用 toss_get_payment 并检查 balanceAmount。
  • 每次取消都会携带 Idempotency-Key（UUID 或调用方提供的密钥），确保重试调用不会重复退款。Toss 端的密钥有效期为 15 天。
  • 使用测试密钥的服务会在每个工具描述中标注 [TEST KEY — sandbox data]，避免 Agent 将沙盒数据误认为真实收入。

开发

pnpm --filter @appmonster/mcp-toss-payments test

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。