Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-server-paystack Create a payment link for NGN 5,000"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Paystack MCP Server — accept payments, verify transactions, and manage customers through AI assistants.
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.
pip install mcp-server-paystackCreate 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.
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 mcp add paystack -e PAYSTACK_SECRET_KEY=sk_test_your_key_here -- mcp-server-paystackAdd to .cursor/mcp.json:
{
"mcpServers": {
"paystack": {
"command": "mcp-server-paystack",
"env": {
"PAYSTACK_SECRET_KEY": "sk_test_your_key_here"
}
}
}
}Related MCP server: Paylo MCP Server
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: 0123456789Tool | Description |
| Create a payment and get a checkout URL |
| Check if a payment was successful |
| List recent transactions with filters |
| Check account balance |
| Create a new customer |
| List customers |
| Create a reusable payment link |
| List supported banks in a country |
| Verify a bank account number |
| Get transaction summary statistics |
Currency | Country |
NGN | Nigeria |
GHS | Ghana |
ZAR | South Africa |
KES | Kenya |
USD | International |
# 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-paystackThe 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
If this project is useful to you, consider supporting it.
MIT
This server cannot be deployed
Nigeria payments for AI agents — bank transfer / USSD via Paystack. Never holds funds.
South Africa payments for AI agents — cards / EFT via Paystack. Never holds funds.
Ghana payments for AI agents — MTN MoMo via Paystack. Never holds funds.
Stripe payments for AI agents. Create links, verify, manage customers.
