Skip to main content
Glama
Payme MCP Server

Payme MCP Server

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.

Related MCP server: payme-mcp

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


Built by SirliAI

Available Tools

6 tools
cards_checkCheck CardA

Check if a card token is valid and get card details (masked number, expiry, status). Example: cards_check({ token: '630e5e...' })

Inputs: token (required).

cards_createCreate Card TokenA

Tokenize a payment card (Uzcard, Humo). Returns a reusable token. After creation, verify the card with SMS code using cards_verify. Example: cards_create({ cardNumber: '8600123456789012', expire: '0399' })

Inputs: expire (required), cardNumber (required), save.

cards_removeRemove CardA

Remove a saved card token. The token will no longer be usable. Example: cards_remove({ token: '630e5e...' })

Inputs: token (required).

cards_verifyVerify CardA

Verify a card using the SMS code sent to the cardholder. Must be called after cards_create. Example: cards_verify({ token: '630e5e...', code: '666666' })

Inputs: code (required), token (required).

receipts_payPay ReceiptA

Pay a receipt using a verified card token. The card must be verified first. Example: receipts_pay({ receiptId: '63...', token: '630e5e...' })

Inputs: token (required), receiptId (required).

receipts_sendSend ReceiptB

Send receipt notification to customer via SMS. Example: receipts_send({ receiptId: '63...', phone: '998901234567' })

Inputs: phone (required), receiptId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: card token lifecycle (create, check, verify, remove) and receipt actions (pay, send). No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent snake_case verb_noun pattern: cards_create, cards_check, cards_verify, cards_remove, receipts_pay, receipts_send.

    Tool Count5/5

    6 tools is well-scoped for a payment card and receipt management server. Each tool earns its place without unnecessary bloat or deficiency.

    Completeness4/5

    Covers the full card token lifecycle and key receipt operations. Minor gap: no refund or receipt status query, but core workflow (tokenize, verify, pay) is complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for AgentPay — the payment gateway for autonomous AI agents. Fund a wallet once, give your agent the key, and it discovers, provisions, and pays for tool APIs on its own. One key, every tool.
      112 npm
      1
      MIT
    • A
      license
      B
      quality
      F
      maintenance
      MCP server for Payme payment system (Uzbekistan). Supports transactions, statements, payment links, and balance queries via JSON-RPC 2.0.
      8
      9 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      A Model Context Protocol server that gives AI agents a typed, safe interface to the iyzico payments API for BIN lookups, installment plans, checkout forms, payment management, and subscriptions.
      MIT