idpay-mcp

MCP server for IDPay payment gateway (Iran). Supports payment creation, verification, inquiry, transaction listing, and payment links. Uses X-API-KEY header with optional X-SANDBOX mode.

Tools (8)

Tool	Description
`create_payment`	Create a payment
`verify_payment`	Verify a payment
`get_payment`	Get payment details
`list_transactions`	List transactions
`create_link`	Create a payment link
`get_link`	Get payment link details
`list_links`	List all payment links
`delete_link`	Delete a payment link

Quick Start

{
  "mcpServers": {
    "idpay": {
      "command": "npx",
      "args": ["-y", "@theyahia/idpay-mcp"],
      "env": {
        "IDPAY_API_KEY": "<YOUR_API_KEY>",
        "IDPAY_SANDBOX": "0"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`IDPAY_API_KEY`	Yes	API key from IDPay dashboard
`IDPAY_SANDBOX`	No	Set to "1" for sandbox mode

Demo Prompts

"Create a payment for 50000 IRR with order ID ORD-001"
"Verify payment abc123 for order ORD-001"
"List my recent transactions"
"Create a payment link for 100000 IRR"
"Delete payment link lnk_abc123"

License

MIT

@theyahia/idpay-mcp

Quick Install