Payfast MCP Server

MCP server for PayFast — AI assistants interact with South Africa's payment gateway

Local serverstdio

What is the Payfast MCP Server?

MCP server for PayFast — AI assistants interact with South Africa's payment gateway

What the server does

High-risk operations require human approval before execution.

  • Transaction management — — fetch transaction details, query history, process tokenized charges
  • Subscription management — — fetch, pause, unpause, cancel, update, and ad-hoc charge subscriptions
  • Refund processing — — create refunds (full or partial) and query refund status
  • Credit card queries — — look up credit card transaction details
  • Sandbox support — — defaults to sandbox mode for safe testing
  • Secure by design — — credentials via environment variables only, sensitive data never logged

Credentials and setup notes

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
pingTest API connectivity
transaction_fetchGet transaction by ID
transaction_historyQuery transaction history
transaction_chargeCharge a stored token
subscription_fetchGet subscription details
subscription_pausePause a subscription
subscription_unpauseResume a subscription
subscription_cancelCancel a subscription
subscription_updateUpdate subscription terms
subscription_adhocAd-hoc subscription charge
refund_createProcess a refund
refund_fetchGet refund details
creditcard_fetchQuery card transaction

How to install the Payfast MCP Server

{
  "mcpServers": {
    "payfast": {
      "command": "npx",
      "args": ["-y", "payfast-mcp"],
      "env": {
        "PAYFAST_MERCHANT_ID": "your-merchant-id",
        "PAYFAST_MERCHANT_KEY": "your-merchant-key",
        "PAYFAST_PASSPHRASE": "your-passphrase",
        "PAYFAST_ENVIRONMENT": "sandbox"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PAYFAST_MERCHANT_IDConfiguration value read at startup.Optional
PAYFAST_MERCHANT_KEYCredential the server authenticates with.Yes
PAYFAST_PASSPHRASEConfiguration value read at startup.Optional
PAYFAST_ENVIRONMENTConfiguration value read at startup.Optional

Example prompts to try

  • “Use Payfast to ping.”
  • “Use Payfast to transaction fetch.”
  • “Use Payfast to transaction history.”

Frequently asked questions

MCP server for PayFast — AI assistants interact with South Africa's payment gateway Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.