Skip to main content
Glama
TRINITY-21

mcp-server-paystack

by TRINITY-21
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-server-paystack

Paystack MCP Server — accept payments, verify transactions, and manage customers through AI assistants.

PyPI Downloads Python License

An MCP server that connects AI assistants (Claude, Cursor, etc.) to the Paystack API. Initialize payments, verify transactions, manage customers, create payment links, check balances, and more — all through natural language.

Stripe has an MCP server. Now Africa's biggest payment platform does too.

Quick Start

Install

pip install mcp-server-paystack

Get Your API Key

  1. Create a free account at paystack.com

  2. Go to Settings > API Keys & Webhooks

  3. Copy your Test Secret Key (sk_test_...)

Test mode is completely free — no real money is involved.

Configure

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "paystack": {
      "command": "mcp-server-paystack",
      "env": {
        "PAYSTACK_SECRET_KEY": "sk_test_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add paystack -e PAYSTACK_SECRET_KEY=sk_test_your_key_here -- mcp-server-paystack

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "paystack": {
      "command": "mcp-server-paystack",
      "env": {
        "PAYSTACK_SECRET_KEY": "sk_test_your_key_here"
      }
    }
  }
}

What You Can Do

You:    "Create a payment link for NGN 5,000 for my consultation fee"
Claude: Done! Payment link: https://paystack.com/pay/consultation-fee

You:    "Check my Paystack balance"
Claude: Your balance is NGN 125,000.00

You:    "Show me all successful transactions from last week"
Claude: Transactions (showing 8 of 8):
          ref_001  |  NGN 5,000.00  |  success  |  john@email.com  |  2026-02-10
          ref_002  |  NGN 12,500.00 |  success  |  jane@email.com  |  2026-02-11
          ...

You:    "Verify the payment with reference TXN_abc123"
Claude: Transaction: TXN_abc123
        Status: PAID
        Amount: NGN 10,000.00
        Channel: card
        Customer: customer@email.com

You:    "Resolve account number 0123456789 at Access Bank (code 044)"
Claude: Account verified!
        Account name: JOHN DOE
        Account number: 0123456789

Available Tools

Tool

Description

paystack_initialize_transaction

Create a payment and get a checkout URL

paystack_verify_transaction

Check if a payment was successful

paystack_list_transactions

List recent transactions with filters

paystack_check_balance

Check account balance

paystack_create_customer

Create a new customer

paystack_list_customers

List customers

paystack_create_payment_page

Create a reusable payment link

paystack_list_banks

List supported banks in a country

paystack_resolve_account

Verify a bank account number

paystack_transaction_totals

Get transaction summary statistics

Supported Currencies

Currency

Country

NGN

Nigeria

GHS

Ghana

ZAR

South Africa

KES

Kenya

USD

International

Development

# Clone the repo
git clone https://github.com/TRINITY-21/mcp-server-paystack.git
cd mcp-server-paystack

# Install in development mode
pip install -e .

# Run tests
python -m pytest tests/ -v

# Run the server locally
PAYSTACK_SECRET_KEY=sk_test_xxx mcp-server-paystack

How It Works

  1. The MCP server runs as a local process, communicating via stdio

  2. AI assistants discover the available Paystack tools through the MCP protocol

  3. When you ask a payment-related question, the assistant calls the appropriate tool

  4. The tool makes an authenticated request to the Paystack API and returns formatted results

  5. All amounts are accepted in main currency units (e.g., 5000 for NGN 5,000) and converted internally

Support

If this project is useful to you, consider supporting it.

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/TRINITY-21/mcp-server-paystack'

If you have feedback or need assistance with the MCP directory API, please join our Discord server