zarinpal-mcp

MCP server for Zarinpal payment gateway (Iran). Supports payment creation, verification, refunds, sandbox mode, and transaction listing. Uses Merchant ID authentication in request body.

Tools (8)

Tool	Description
`create_payment`	Create a payment request
`verify_payment`	Verify a completed payment
`get_unverified`	List unverified payments
`list_transactions`	List payment transactions
`refund`	Refund a payment
`create_sandbox_payment`	Create a sandbox test payment
`get_fees`	Calculate fees for an amount
`get_authority_status`	Check payment status by authority

Quick Start

{
  "mcpServers": {
    "zarinpal": {
      "command": "npx",
      "args": ["-y", "@theyahia/zarinpal-mcp"],
      "env": {
        "ZARINPAL_MERCHANT_ID": "<YOUR_MERCHANT_ID>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`ZARINPAL_MERCHANT_ID`	Yes	Merchant ID from Zarinpal dashboard

Demo Prompts

"Create a payment for 100000 IRR with callback to https://mysite.com/pay"
"Verify payment with authority A000..."
"List all unverified payments"
"Refund 50000 IRR for authority A000..."
"Create a sandbox test payment"

License

MIT

@theyahia/zarinpal-mcp

Quick Install