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 6 months ago comms
InstallView source
52Fair

Scored 4 months 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. It has been installed 0 times through Conduid.

The repository has 1 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx 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.

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

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !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 mirrored from the source repository 4 months ago. The original is authoritative.

Questions

About Paystack

How do I install Paystack?

Run npx mcp-server-paystack, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Paystack safe to use with an AI agent?

Its trust score is 52 out of 100 (fair). It passes 0 of 1 static security checks; 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 6 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.