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.