Server Paystack

FreeNot checked

Enables AI assistants to accept payments, verify transactions, and manage customers via Paystack API through natural language.

by TRINITY-21

GitHub Embed

About

Enables AI assistants to accept payments, verify transactions, and manage customers via Paystack API through natural language.

README

mcp-server-paystack

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

PyPI Downloads

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

Create a free account at paystack.com
Go to Settings > API Keys & Webhooks
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  |  [email protected]  |  2026-02-10
          ref_002  |  NGN 12,500.00 |  success  |  [email protected]  |  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: [email protected]

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

The MCP server runs as a local process, communicating via stdio
AI assistants discover the available Paystack tools through the MCP protocol
When you ask a payment-related question, the assistant calls the appropriate tool
The tool makes an authenticated request to the Paystack API and returns formatted results
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

from github.com/TRINITY-21/mcp-server-paystack

Install Server Paystack in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install mcp-server-paystack

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add mcp-server-paystack -- uvx mcp-server-paystack

FAQ

Is Server Paystack MCP free?

Yes, Server Paystack MCP is free — one-click install via Unyly at no cost.

Does Server Paystack need an API key?

No, Server Paystack runs without API keys or environment variables.

Is Server Paystack hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Server Paystack in Claude Desktop, Claude Code or Cursor?

Open Server Paystack on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Fetch

Web content fetching and conversion for efficient LLM usage.

by Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

by modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.