Skip to main content
Glama

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_payment_page

Create a hosted payment page

query_transaction

Query transaction details

refund_transaction

Refund a completed transaction

create_token

Tokenize a card for recurring payments

charge_token

Charge a saved card token

list_transactions

List transactions by date range

void_transaction

Void a pending transaction

get_payment_methods

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

PAYTABS_PROFILE_ID

Yes

Merchant profile ID

PAYTABS_SERVER_KEY

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 tools
charge_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

    A3.6/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct action: creating payment pages, querying, refunding, voiding, tokenization, charging tokens, listing, and fetching methods. No overlap exists.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (create_, query_, refund_, void_, list_, get_, charge_). The naming convention is uniform and predictable.

    Tool Count5/5

    With 8 tools, the set is well-scoped for a payment processing server, covering core payment operations without being bloated or sparse.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server for VNPay payment gateway (Vietnam). Supports payment URL generation, transaction queries, refunds, tokenized payments, and IPN verification with HMAC-SHA512 signing.
      8
      10 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for PayMongo payment gateway (Philippines). Supports payment intents, sources, payments, refunds, and checkout sessions via Basic Auth.
      24
      22 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for JazzCash mobile wallet and payments (Pakistan). Supports wallet payments, mobile account payments, vouchers, refunds, and balance inquiries.
      5
      15 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for MAIB e-commerce payments (Moldova). Supports payments, refunds, recurring billing, one-click payments, and transaction status via OAuth 2.0.
      8
      13 npm
      MIT