概要
What is Kazakhstan Payments MCP?
A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Kazakhstan via Freedom Pay’s hosted checkout. It supports cards, Apple Pay, and Google Pay, acting as a stateless translation layer—funds flow directly from buyer to merchant without storing credentials or maintaining a database.
How to use Kazakhstan Payments MCP?
Connect to the endpoint https://mcp-kz.wishpool.app/mcp using Streamable HTTP. Provide your Freedom Pay merchant ID in the x-freedompay-merchant-id header; optionally set x-freedompay-mode: test for test mode. Use the tools create_payment_link to generate a KZT checkout link and query_payment_status to check if a payment is completed.
Key features of Kazakhstan Payments MCP
- Accepts cards, Apple Pay, and Google Pay in Kazakhstan.
- Stateless, credential‑free, zero‑database architecture.
- Remote MCP server with Streamable HTTP transport.
- Two tools: create payment link and query status.
- Part of an 81‑country payment family.
- No runtime dependencies; Node.js 18+ required.
Use cases of Kazakhstan Payments MCP
- AI assistants generating payment links for Kazakhstani customers.
- Automated checkout in chatbots or code‑generation agents.
- Pull‑based payment status verification for order fulfillment.
- Test‑mode integration during development without real money.
FAQ from Kazakhstan Payments MCP
How does Kazakhstan Payments MCP handle payment credentials?
It never stores funds or credentials. Merchants supply their Freedom Pay merchant ID via the x-freedompay-merchant-id header; the server forwards it to Freedom Pay and does not retain it.
What runtime or dependencies are required?
Node.js 18 or later is required. The server has zero runtime dependencies.
Where do payment funds go?
Funds flow directly from the buyer to Freedom Pay and then to the merchant. The MCP server does not hold or process funds.
What transport and authentication does the server use?
It uses Streamable HTTP with stateless JSON‑RPC. Authentication is via custom headers (x-freedompay-merchant-id and optionally x-freedompay-mode).
Is there a test mode available?
Yes. Set the header x-freedompay-mode: test to operate in test mode during development.
