Kazakhstan Payments (Freedom Pay — cards (Freedom Pay))

Official2 tools

by junter1989k-ai · JavaScript

Kazakhstan payments for AI agents — cards (Freedom Pay) via Freedom Pay. Never holds funds.

This MCP server provides Kazakhstan payments for AI agents, using cards via Freedom Pay (“Freedom Pay”). The system is described as never holding funds. It exposes 2 tools and can be configured through an MCP-capable client by adding an HTTP server URL.

🛠️ Key Features

Kazakhstan payments for AI agents
Card payments via Freedom Pay
“Never holds funds”
Tooling count: 2
Topics include ai-agent, claude, kazakhstan, mcp, mcp-server, payments, wishpool

🚀 Use Cases

Enable AI agents to accept payments in Kazakhstan
Integrate with MCP clients like Claude Desktop, Cursor, and Windsurf

⚡ Developer Benefits

No local installation required
When credentials are needed, they are passed as HTTP headers per request
Credentials are “never stored” (per the provided threat model reference)

⚠️ Limitations

Designed for Kazakhstan payments using Freedom Pay card payments
HTTP transport is required (configured via an http MCP server URL)

Topics

ai-agentclaudekazakhstanmcpmcp-serverpaymentswishpool

Captured live from the server via tools/list.

create_payment_link

Create a payment link in KZT for Kazakhstan via Freedom Pay. Buyer pays with cards, Apple Pay / Google Pay via Freedom Pay. Returns a hosted checkout URL the buyer opens to pay — payment completes automatically, no confirm step. Bring your own credentials via HTTP header (x-freedompay-merchant-id; free test credentials from freedompay.kz never move real money). Money always flows buyer→Freedom Pay→merchant; this service never touches funds.

Parameters5

amount_kzt	integer	required	Amount in KZT (integer), e.g. 1000. Minimum 100.
description	string	required	What this payment is for (shown to the buyer, ≤200 chars)
customer_email	string	optional	Optional buyer email.
reference_id	string	optional	Your unique order reference (≤40 chars). Auto-generated if omitted.
success_url	string	optional	Optional https URL to send the buyer to after payment.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_kzt": {
      "type": "integer",
      "minimum": 100,
      "maximum": 100000000,
      "description": "Amount in KZT (integer), e.g. 1000. Minimum 100."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤200 chars)"
    },
    "customer_email": {
      "type": "string",
      "description": "Optional buyer email."
    },
    "reference_id": {
      "type": "string",
      "description": "Your unique order reference (≤40 chars). Auto-generated if omitted."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after payment."
    }
  },
  "required": [
    "amount_kzt",
    "description"
  ]
}

query_payment_status

Check whether a Kazakhstan payment (created by create_payment_link) has been paid. Queries Freedom Pay directly — pull-based, no webhook needed. paid=true when status is PAID.

Parameters1

order_id

string

required

The order_id returned by create_payment_link

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The order_id returned by create_payment_link"
    }
  },
  "required": [
    "order_id"
  ]
}

README.md2 KBView on GitHub

Kazakhstan Payments MCP — let AI agents accept payments in Kazakhstan

Use it in 60 seconds

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

json

{
  "mcpServers": {
    "kazakhstan-payments": {
      "type": "http",
      "url": "https://mcp-kz.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:

bash

git clone https://github.com/junter1989k-ai/kazakhstan-payments-mcp && cd kazakhstan-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-kz.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/kazakhstan-payments-mcp · Part of a 81-country family — hub: mcp.wishpool.app

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Kazakhstan: cards, Apple Pay / Google Pay via Freedom Pay — via Freedom Pay's hosted checkout.

⚖️ Stateless translation layer: funds always flow buyer → Freedom Pay → merchant directly. Never holds funds or stores credentials — no database at all.

Quick start

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

Header	Value
`x-freedompay-merchant-id`	your Freedom Pay merchant credentials from freedompay.kz (send x-freedompay-mode: test for test mode)

Tools

Tool	What it does
`create_payment_link`	Create a KZT hosted-checkout link.
`query_payment_status`	Pull-based status check; `paid=true` when PAID.

Develop

bash

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

Zero runtime dependencies; Node ≥ 18. MIT license.

Install

Tools (2)

create_payment_linkquery_payment_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-kz.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json