Korea Payments MCP — 한국에서 AI 에이전트가 결제 링크를 만들 수 있는 MCP 서버

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

{
  "mcpServers": {
    "korea-payments": {
      "type": "http",
      "url": "https://mcp-kr.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

git clone https://github.com/junter1989k-ai/korea-payments-mcp && cd korea-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-kr.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/korea-payments-mcp · Sister servers: Taiwan · Japan · Indonesia · India

English below. / 한국어는 아래를 참고하세요.

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Korea:

💳 Card 카드 — the checkout window also shows easy-pay wallets (KakaoPay 카카오페이 / NaverPay 네이버페이 / Toss Pay) enabled on the merchant contract
🏦 Virtual account 가상계좌 / instant bank transfer 계좌이체 / carrier billing 휴대폰
🔍 Payment status check — pull-based, no webhook needed
✅ confirm_payment — Toss's required approval step, exposed honestly as a tool

v0.1 routes through Toss Payments (토스페이먼츠), a major Korean payment gateway. The provider registry is built for aggregation — more Korean gateways join behind the same tools.

⚖️ Stateless translation layer: funds always flow buyer → Toss Payments → merchant directly. This server never holds, moves, or stores funds or credentials — no database at all.

Why this exists

Korean payment rails — Toss checkout, KakaoPay/NaverPay wallets, 가상계좌 virtual accounts — are built for humans clicking through web pages. An AI agent has no agent-ready API for "let my Korean customer pay". This MCP server translates that flow into tools an agent can call.

Quick start

MCP endpoint: https://mcp-kr.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Add the server URL in any remote-MCP client (Claude Desktop / Claude Code / Cursor…), then send your Toss Payments key as a header on each request:

Header	Value
`x-toss-secret-key`	Your Toss Payments secret key. `test_sk_...` / `test_gsk_...` = test mode (no real money, free after signing up at developers.tosspayments.com); `live_sk_...` = production.

No public demo key exists for Toss Payments, so bring your own — a test key takes a minute to get and never moves real money.

The Toss flow (three steps, honestly)

Toss Payments separates authentication from approval:

create_payment_link → buyer opens payment_url and authenticates
Poll query_payment_status → status becomes IN_PROGRESS
confirm_payment within 10 minutes (same amount = built-in tamper check) → DONE

Virtual accounts: confirm issues the account (WAITING_FOR_DEPOSIT); DONE arrives after the buyer deposits.

Tools

Tool	What it does
`create_payment_link`	Create a KRW checkout link (card / virtual_account / transfer / mobile_phone). Returns the hosted checkout URL.
`query_payment_status`	Check status: READY / IN_PROGRESS / WAITING_FOR_DEPOSIT / DONE / CANCELED / ABORTED / EXPIRED.
`confirm_payment`	Approve the payment after buyer authentication (required Toss step).

Develop

node test/serve.js      # local server (http://localhost:3213/mcp)
node test/e2e.js        # protocol + validation suite (probes real Toss auth errors)

Zero runtime dependencies; Node ≥ 18.

English summary

Remote MCP server for Korea payments: card (with KakaoPay / NaverPay / Toss Pay wallets), virtual account (가상계좌), instant bank transfer, carrier billing — via Toss Payments' hosted checkout. Bring-your-own credentials (x-toss-secret-key), stateless, never touches funds, MIT-licensed, zero dependencies. Endpoint: https://mcp-kr.wishpool.app/mcp.

Part of a family: Taiwan Payments MCP (ECPay 綠界 / NewebPay 藍新 + government e-invoices) · Japan Payments MCP (KOMOJU — konbini / PayPay) · Indonesia Payments MCP (Midtrans Snap — GoPay / QRIS / Alfamart) · India Payments MCP (Razorpay Payment Links — UPI / cards).

Korea Payments (Toss Payments — cards / KakaoPay·NaverPay / virtual accounts)