Payme MCP Server

MCP server for Payme — the leading payment system in Uzbekistan. Enables AI agents (Claude, GPT, Cursor, etc.) to process payments, manage cards, and generate checkout links through the Model Context Protocol.

Why?

Stripe, PayPal, and Square all have MCP servers. Payme didn't — until now. If you're building AI agents for Uzbekistan's market, this is the missing piece.

Tools

| Tool | Description | |------|-------------| | cards_create | Tokenize a payment card (Uzcard, Humo) | | cards_verify | Verify card with SMS code | | cards_check | Check if a card token is valid | | cards_remove | Remove a saved card | | receipts_create | Create a payment receipt (invoice) | | receipts_pay | Pay a receipt with a card token | | receipts_send | Send receipt notification via SMS | | receipts_cancel | Cancel/refund a receipt | | receipts_check | Check receipt status | | checkout_url | Generate a Payme checkout payment link |

Quick Start

npx payme-mcp

That's it. One command — downloads, installs, and runs automatically.

Get your credentials from merchant.paycom.uz, then add to your AI tool:

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "payme": {
      "command": "npx",
      "args": ["-y", "payme-mcp"],
      "env": {
        "PAYME_ID": "your_merchant_id",
        "PAYME_KEY": "your_merchant_key",
        "PAYME_TEST": "true"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "payme": {
      "command": "npx",
      "args": ["-y", "payme-mcp"],
      "env": {
        "PAYME_ID": "your_merchant_id",
        "PAYME_KEY": "your_merchant_key",
        "PAYME_TEST": "true"
      }
    }
  }
}

Cursor / VS Code / Windsurf

Add to MCP settings:

{
  "payme": {
    "command": "npx",
    "args": ["-y", "payme-mcp"],
    "env": {
      "PAYME_ID": "your_merchant_id",
      "PAYME_KEY": "your_merchant_key"
    }
  }
}

Usage Examples

Once connected, your AI agent can:

Create a payment link:

"Generate a Payme checkout link for order #1234, amount 99,000 UZS"

Process a card payment:

"Tokenize card 8600XXXXXXXXXXXX, verify it, then charge 50,000 UZS"

Check payment status:

"Check the status of receipt 63abc..."

Cancel a payment:

"Cancel receipt 63abc... and notify the customer"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | PAYME_ID | Yes | Your Payme merchant ID | | PAYME_KEY | Yes | Your Payme merchant key | | PAYME_TEST | No | Set to true for sandbox mode |

Amount Format

Payme uses tiyin (1 UZS = 100 tiyin):

| UZS | Tiyin | |-----|-------| | 1,000 | 100,000 | | 9,900 | 990,000 | | 99,000 | 9,900,000 | | 990,000 | 99,000,000 |

Receipt States

| State | Meaning | |-------|---------| | 0 | Created (waiting for payment) | | 4 | Paid | | 21 | Held (funds reserved) | | 50 | Cancelled |

Development

git clone https://github.com/sirliboyev-uz/payme-mcp.git
cd payme-mcp
npm install
npm run build

Security

• Card numbers are tokenized by Payme — tokens are safe to store
• Never log or store raw card numbers
• Use PAYME_TEST=true for development/testing
• All API calls use HTTPS

License

MIT — see LICENSE

Links

• Payme Developer Docs
• MCP Protocol
• MCP TypeScript SDK

Built by SirliAI