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.
| 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
node test/e2e.js
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).