Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
<div align="center">
mcp-server-paystack
Paystack MCP Server — accept payments, verify transactions, and manage customers through AI assistants.
</div>
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-paystackGet 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: 0123456789Available 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-paystackHow 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.
<a href="https://buymeacoffee.com/trinity_21" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="40"></a>
License
MIT