idpay-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@idpay-mcp Create a payment for 50000 IRR with order ID ORD-001"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 a payment |
| Verify a payment |
| Get payment details |
| List transactions |
| Create a payment link |
| Get payment link details |
| List all payment links |
| Delete a payment link |
Related MCP server: vnpay-mcp
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 |
| Yes | API key from IDPay dashboard |
| 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
Available Tools
8 toolscreate_linkC
Create a payment link.
Inputs: amount (required), description (required), name.
create_paymentC
Create an IDPay payment.
Inputs: amount (required), callback (required), order_id (required), mail, +3 more.
delete_linkB
Delete a payment link.
Inputs: link_id (required).
get_linkB
Get payment link details.
Inputs: link_id (required).
get_paymentC
Get payment details by ID.
Inputs: id (required), order_id (required).
list_linksA
List all payment links.
Inputs: no named parameters.
list_transactionsC
List payment transactions.
Inputs: page, date_to, date_from, page_size.
verify_paymentD
Verify an IDPay payment.
Inputs: id (required), order_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool clearly targets a distinct resource: payment links (list/create/get/delete) and payments (create/verify/get), with transactions listed separately. There is no ambiguity as the purpose of each tool is unique.
All tool names follow a consistent verb_noun pattern (e.g., list_links, create_payment, verify_payment). The verbs and nouns are predictable and consistently use snake_case.
With 8 tools, the server is well-scoped for a payment processing domain, covering both payments and payment links without unnecessary redundancy. The number is appropriate and neither too sparse nor overwhelming.
The tool set covers the core lifecycle for payments (create, verify, get) and payment links (create, list, get, delete). The only notable missing operation is an update for payment links, but this is a minor gap and does not severely hinder the primary workflows.
Related MCP Connectors
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
A paid remote MCP for AI SDK MCP gateway registry, built to return verdicts, receipts, usage logs, a
Official BlindPay MCP server: stablecoin payouts, payins, quotes and customers for global payments.
Tenzro Network MCP server: wallet, identity, payments, inference, staking, bridges, verification.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Python-based MCP server for managing Paytm payment links and transactions. It enables users to create payment links, list created links, and retrieve transaction details for specific payment links.-
- AlicenseBqualityDmaintenanceMCP server for VNPay payment gateway (Vietnam). Supports payment URL generation, transaction queries, refunds, tokenized payments, and IPN verification with HMAC-SHA512 signing.810 npmMIT
- AlicenseBqualityFmaintenanceMCP server for Payme payment system (Uzbekistan). Supports transactions, statements, payment links, and balance queries via JSON-RPC 2.0.8MIT
- AlicenseAqualityDmaintenanceMCP server for Bank of Georgia iPay payment gateway, enabling payment orders, refunds, recurring payments, and pre-authorization via OAuth 2.0 + JWT.816 npmMIT