1. Conduid
  2. Finance
  3. Paystack
MCP server · Finance

Paystack

by · github.com/TRINITY-21/mcp-server-paystack

The Paystack Model Context Protocol (MCP) server allows AI agents to interact with Paystack through standardized MCP clients via tool calling. This protocol supports various tools to interact with different Paystack services.

Unclaimed MIT last commit 8 months ago finance
InstallView source
52Fair

Scored a month ago · breakdown

About Paystack

Paystack is an MCP server published by TRINITY-21 in the Finance category: the Paystack Model Context Protocol (MCP) server allows AI agents to interact with Paystack through standardized MCP clients via tool calling. This protocol supports various tools to interact with different Paystack services.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/TRINITY-21/mcp-server-paystack

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (10)

paystack_check_balanceCheck account balance

Parameters not published.

paystack_create_customerCreate a new customer

Parameters not published.

paystack_create_payment_pageCreate a reusable payment link

Parameters not published.

paystack_initialize_transactionCreate a payment and get a checkout URL

Parameters not published.

paystack_list_banksList supported banks in a country

Parameters not published.

paystack_list_customersList customers

Parameters not published.

paystack_list_transactionsList recent transactions with filters

Parameters not published.

paystack_resolve_accountVerify a bank account number

Parameters not published.

paystack_transaction_totalsGet transaction summary statistics

Parameters not published.

paystack_verify_transactionCheck if a payment was successful

Parameters not published.

Ask AI

✦

Ask AI about Paystack

Powered by Claude · Grounded in docs

I know everything about Paystack. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 18 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • !Dependencies pinnedNo lockfile. Installs can pull different code over time.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

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

README fetched from the repository 18 hours ago. The original is authoritative.

Questions

About Paystack

How do I install Paystack?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Paystack safe to use with an AI agent?

Its trust score is 52 out of 100 (fair). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Paystack still maintained?

The last commit was 8 months ago and 1 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.