paytabs-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., "@paytabs-mcp Create a payment page for 500 SAR"
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.
paytabs-mcp
MCP server for PayTabs payment gateway (MENA region). Supports payment pages, transactions, refunds, voids, tokenization, and payment method discovery.
Tools (8)
Tool | Description |
| Create a hosted payment page |
| Query transaction details |
| Refund a completed transaction |
| Tokenize a card for recurring payments |
| Charge a saved card token |
| List transactions by date range |
| Void a pending transaction |
| Get available payment methods |
Related MCP server: paymongo-mcp
Quick Start
{
"mcpServers": {
"paytabs": {
"command": "npx",
"args": ["-y", "@theyahia/paytabs-mcp"],
"env": {
"PAYTABS_PROFILE_ID": "<YOUR_PROFILE_ID>",
"PAYTABS_SERVER_KEY": "<YOUR_SERVER_KEY>"
}
}
}
}Environment Variables
Variable | Required | Description |
| Yes | Merchant profile ID |
| Yes | Server key from PayTabs dashboard |
Demo Prompts
"Create a payment page for 500 SAR for electronics order"
"Check status of transaction TST2026040112345"
"Refund 200 SAR from transaction TST2026040112345"
"Void pending transaction TST2026040198765"
"What payment methods are available for AED?"
License
MIT
Available Tools
8 toolscharge_tokenB
Charge a saved card token.
Inputs: token (required), amount (required), currency, cart_description.
create_payment_pageB
Create a hosted payment page via PayTabs.
Inputs: amount (required), cart_id (required), return_url (required), callback_url (required), +2 more.
create_tokenB
Tokenize a card for recurring payments.
Inputs: cvv (required), return_url (required), card_number (required), expiry_year (required), +1 more.
get_payment_methodsB
Get available payment methods for a currency.
Inputs: currency.
list_transactionsB
List transactions by date range.
Inputs: date_to (required), date_from (required).
query_transactionB
Query transaction details by reference.
Inputs: tran_ref (required).
refund_transactionB
Refund a completed transaction.
Inputs: amount (required), tran_ref (required), cart_description.
void_transactionC
Void a pending transaction.
Inputs: tran_ref (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 targets a distinct action: creating payment pages, querying, refunding, voiding, tokenization, charging tokens, listing, and fetching methods. No overlap exists.
All tool names follow a consistent verb_noun pattern (create_, query_, refund_, void_, list_, get_, charge_). The naming convention is uniform and predictable.
With 8 tools, the set is well-scoped for a payment processing server, covering core payment operations without being bloated or sparse.
The surface covers the main payment lifecycle: creation, querying, refund, void, tokenization, and charging tokens. A minor gap is the lack of a capture/settlement operation, but most workflows are supported.
Related MCP Connectors
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.
Related MCP Servers
- 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
- AlicenseAqualityCmaintenanceMCP server for PayMongo payment gateway (Philippines). Supports payment intents, sources, payments, refunds, and checkout sessions via Basic Auth.2422 npm2MIT
- AlicenseAqualityBmaintenanceMCP server for JazzCash mobile wallet and payments (Pakistan). Supports wallet payments, mobile account payments, vouchers, refunds, and balance inquiries.515 npm1MIT
- AlicenseAqualityDmaintenanceMCP server for MAIB e-commerce payments (Moldova). Supports payments, refunds, recurring billing, one-click payments, and transaction status via OAuth 2.0.813 npmMIT