Toss Payments

io.github.groove79由 GitHub 账号 groove79 发布v0.2.0更新于 Oct 24, 2026

Toss Payments MCP: payment lookup, approval-gated cancel/refund, settlements. 토스페이먼츠 MCP.

发布方自己的服务：Payments Ai Mcp

已验证STDIO仅桌面金融商业与电商

服务详情

标识符: io.github.groove79/mcp-toss-payments
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Oct 23, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 groove79。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.groove79%2Fmcp-toss-payments.svg)](https://sourceweft.com/mcp/io.github.groove79%2Fmcp-toss-payments?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

面向 Toss Payments 的本地 MCP 服务器，让助手查询支付、列出交易与结算，并在人工批准后取消或退款。

可以做什么: 按 paymentKey 或 orderId 查询单笔支付，含状态、金额、余额、支付方式、取消记录与收据链接
按日期范围列出已批准与已取消的交易，最多 5000 条，支持游标分页
读取结算记录，含手续费、增值税与打款金额，可按销售日或打款日查询并附合计
整笔或部分取消支付，自动附带幂等键，执行前需预览确认或手机审批
适用场景: 适用于使用韩国 Toss Payments 的场景：希望助手查询支付状态、核对交易或查看结算，并在人工审批把关下处理退款，而不是手工操作。
运行要求: 通过 npx 以 npm 包形式在本机运行（需 Node.js）。需在 TOSS_SECRET_KEY 中提供 Toss Payments 密钥，test_sk_ 开头为沙箱数据，live_sk_ 开头为真实支付。可选 OKAGENT_API_KEY 启用 KakaoTalk 手机审批；KMCP_WRITE_MODE 可设为 approval、confirm 或 direct。

安装前请注意

toss_cancel_payment 会动用真实资金且不可撤销，使用 live_sk_ 密钥时影响真实支付。服务器持有支付密钥，可选的 OKAGENT_API_KEY 会把审批请求发送给第三方服务。KMCP_WRITE_MODE=direct 会关闭确认检查，仅对完全信任的脚本使用。

安装

在 SourceWeft 中

打开控制台中的 Toss Payments，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

@appmonster/mcp-toss-payments

MCP server for Toss Payments (토스페이먼츠) core API. An agent can look up a payment, reconcile transactions, read settlements — and cancel/refund, which is the one tool that moves real money and is built to run behind a human approval (OK Agent).

토스페이먼츠 MCP 서버 — 결제 조회, 거래 내역, 정산, 취소/환불(승인 게이트).

Tools

Tool	Access	What it does
`toss_get_payment`	read	paymentKey 또는 orderId로 결제 1건: 상태, 금액, 잔액, 수단, 취소 이력, 영수증 URL
`toss_cancel_payment`	write	전체/부분 취소. 가상계좌는 환불계좌 필수. Idempotency-Key 자동 부여
`toss_list_transactions`	read	기간별 거래(승인·취소) 목록, 최대 5000건, startingAfter 커서
`toss_list_settlements`	read	정산 내역(수수료·부가세·지급액), 매출일/지급일 기준, 합계 포함

Setup

https://developers.tosspayments.com → 내 개발정보 → API 키. 먼저 test_sk_…로 시작하세요 (테스트 결제 데이터로 동작).
MCP client config:

json

{  "mcpServers": {    "toss-payments": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-toss-payments"],      "env": { "TOSS_SECRET_KEY": "test_sk_…" }    }  }}

{  "mcpServers": {    "toss-payments": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-toss-payments"],      "env": { "TOSS_SECRET_KEY": "test_sk_…" }    }  }}

Human approval for cancels (strongly recommended with a live key)

Without it, write tools still never run blind: the first call returns a preview and a confirm_token, and the agent re-calls only after you agree in the chat. With an OK Agent key (free, 200/month) the request goes to your phone instead — approve on KakaoTalk, with a log. KMCP_WRITE_MODE=direct turns the check off for scripts you fully trust.

With a live_sk_ key the server prints a warning at start if no approval hook is configured.

Safety notes

toss_cancel_payment is irreversible. The tool description tells the agent to call toss_get_payment first and check balanceAmount.
Every cancel carries an Idempotency-Key (UUID, or the caller's own key) so a retried call cannot refund twice. Keys are valid 15 days on Toss's side.
Test-key servers tag every tool description with [TEST KEY — sandbox data] so the agent never mistakes sandbox numbers for real revenue.