Toss Payments runs on your own machine — the client starts it, so there is no endpoint to ping. 24 installs a week from npm. Last commit 24 Oct 2026.
Toss Payments MCP: payment lookup, approval-gated cancel/refund, settlements. 토스페이먼츠 MCP.
Nothing serious here today
Today is the operative word: we check Toss Payments every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add mcp-toss-payments -e 'TOSS_SECRET_KEY=<TOSS_SECRET_KEY>' -- npx -y @appmonster/mcp-toss-payments{
"mcpServers": {
"mcp-toss-payments": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-toss-payments"
],
"env": {
"TOSS_SECRET_KEY": "<TOSS_SECRET_KEY>"
}
}
}
}[mcp_servers.mcp-toss-payments]
command = "npx"
args = ["-y", "@appmonster/mcp-toss-payments"]
env = { TOSS_SECRET_KEY = "<TOSS_SECRET_KEY>" }{
"mcpServers": {
"mcp-toss-payments": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-toss-payments"
],
"env": {
"TOSS_SECRET_KEY": "<TOSS_SECRET_KEY>"
}
}
}
}{
"servers": {
"mcp-toss-payments": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-toss-payments"
],
"env": {
"TOSS_SECRET_KEY": "<TOSS_SECRET_KEY>"
}
}
}
}Put your own value in place of
<TOSS_SECRET_KEY> (Secret key (test_sk_… or live_sk_…) from the Toss Payments developer center).
The author’s registry entry marks it as required.
Optional settings from the registry entry, left out of the block above:
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_MODE (approval | confirm | direct (default: approval if OKAGENT_API_KEY is set, else confirm)).
Alternatives to Toss Payments
same job, measured the same wayMCP server for YooKassa payment API — payments, refunds, receipts (54-FZ). 10 tools. First MCP for
Read splose patients, appointments, invoices, cases; book and cancel appointments, record payments.
Review AurasPay merchant payments and prepare payment links with scoped OAuth and human approval.
Sandbox-only MuPag MCP server for approved payments, subscriptions, refunds, and reconciliation.
Unofficial MCP server for the ZEN.com Payment Gateway: payment links, transactions, refunds.
MCP server for T-Kassa (T-Bank/Tinkoff) payment API — payments, refunds. 5 tools. First MCP for T-K
x402 payment wrapper for AI Agents and MCP Servers. USDC settlements on Base L2.
MCP server for dLocal — LatAm cross-border payments, payouts, refunds across 15+ countries
Toss Payments — questions
Answers built from our own checks of this server.