Korea Payments Mcp

What is Korea Payments MCP?

Korea Payments MCP is a remote Model Context Protocol server that lets any AI agent (Claude, ChatGPT, Cursor, etc.) accept payments in South Korea. It routes through Toss Payments (토스페이먼츠), a major Korean payment gateway, and acts as a stateless translation layer between agent tools and Korean payment rails.

How to use Korea Payments MCP?

Add the MCP endpoint https://mcp-kr.wishpool.app/mcp in any remote-MCP client. On each request, send your Toss Payments secret key as the HTTP header x-toss-secret-key. Use a test key (test_sk_... or test_gsk_...) for test mode; use live_sk_... for production.

Key features of Korea Payments MCP

• Accept card payments with KakaoPay, NaverPay, and Toss Pay wallets
• Support virtual account (가상계좌), instant bank transfer, carrier billing
• Pull-based payment status check — no webhook required
• Honest confirm_payment tool for Toss’s required approval step
• Stateless: never holds, moves, or stores funds or credentials
• Zero runtime dependencies, Node ≥ 18, MIT licensed

Use cases of Korea Payments MCP

• An AI agent creates a hosted checkout link so a Korean customer can pay by card or KakaoPay
• An agent polls payment status until the buyer completes authentication, then confirms the payment
• A chatbot generates a virtual account number for a customer to deposit into
• An automation workflow accepts Korean carrier billing payments without manual intervention

FAQ from Korea Payments MCP

What payment methods does Korea Payments MCP support?

Card (with KakaoPay, NaverPay, Toss Pay wallets displayed in checkout), virtual account (가상계좌), instant bank transfer, and carrier billing (휴대폰).

Do I need my own credentials to use Korea Payments MCP?

Yes. You must supply a Toss Payments secret key via the x-toss-secret-key header. A free test key can be obtained from developers.tosspayments.com and never moves real money.

Does Korea Payments MCP store any data or handle funds?

No. It is a stateless translation layer — funds flow directly from buyer to your Toss Payments merchant account. The server has no database and never holds, moves, or stores credentials or funds.

What is the Toss payment flow?

Three steps: (1) create_payment_link → buyer opens the URL and authenticates; (2) poll query_payment_status until IN_PROGRESS; (3) confirm_payment within 10 minutes → DONE. For virtual accounts, confirm issues the account number and DONE arrives after deposit.

Is there a test mode?

Yes. Use a test secret key (test_sk_... or test_gsk_...). No real money is moved, and the key is free after signing up at developers.tosspayments.com.