Paystack
Paystack's MCP Server for Agents
What is Paystack?
Paystack is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to paystack's mcp server for agents
Paystack's MCP Server for Agents
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Paystack's MCP Server for Agents
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @paystack/mcp-serverManual Installation
npx -y @paystack/mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Paystack
The Paystack MCP Server gives AI agents direct access to the Paystack payment API, enabling them to initiate transactions, manage customers, verify payments, and query account data without leaving the conversation. Built and maintained by Paystack's open-source team, it exposes two core tools—one to look up API operation details and one to execute live API requests—so agents can work with the full breadth of Paystack's REST API. It is the fastest way to add payment intelligence to Claude, Cursor, or any other MCP-compatible client operating in African and global markets.
Prerequisites
- Node.js 18 or later installed
- A Paystack account with a secret API key (test key: sk_test_... or live key: sk_live_...)
- An MCP-compatible client such as Claude Desktop, Cursor, or Claude Code
- Basic familiarity with the Paystack API and NGN/USD amounts
Obtain your Paystack secret key
Log in to your Paystack dashboard, navigate to Settings > API Keys & Webhooks, and copy your test or live secret key. Keep this key private.
Run the server via npx
The simplest way to start the server is to pass your API key directly as a CLI argument. No installation step is needed; npx fetches the package on first run.
npx @paystack/mcp-server --api-key sk_test_your_key_hereAdd the server to your MCP client config
Open your MCP client's configuration file (e.g. claude_desktop_config.json for Claude Desktop) and add the Paystack server entry with your secret key.
{
"mcpServers": {
"paystack": {
"command": "npx",
"args": ["-y", "@paystack/mcp-server", "--api-key", "sk_test_your_key_here"]
}
}
}Alternatively, configure via environment variable
If you prefer not to pass the key on the command line, set the PAYSTACK_TEST_SECRET_KEY environment variable and omit the --api-key flag.
{
"mcpServers": {
"paystack": {
"command": "npx",
"args": ["-y", "@paystack/mcp-server"],
"env": {
"PAYSTACK_TEST_SECRET_KEY": "sk_test_your_key_here"
}
}
}
}Restart your MCP client and verify the connection
Restart Claude Desktop (or reload your MCP client). You should see the paystack server listed as connected. Ask the client to list available Paystack operations to confirm.
Paystack Examples
Client configuration
Full claude_desktop_config.json snippet for the Paystack MCP server using npx with the API key passed as a CLI argument.
{
"mcpServers": {
"paystack": {
"command": "npx",
"args": ["-y", "@paystack/mcp-server", "--api-key", "sk_test_your_key_here"]
}
}
}Prompts to try
Include 'Paystack' explicitly in your requests for the best results. The server can perform any operation in the Paystack API.
- "Initialize a Paystack transaction for 50000 NGN for customer [email protected]"
- "Create a new Paystack customer with email [email protected] and first name John"
- "Verify the Paystack transaction with reference abc123xyz"
- "List the last 10 Paystack transactions on my account"
- "Show me the cURL command to create a Paystack payment plan"Troubleshooting Paystack
Authentication error: 'Invalid key' when making API calls
Confirm you are using the correct key type for your environment. Test-mode operations require sk_test_... keys. Live-mode keys (sk_live_...) are only needed for real transactions and require a verified Paystack account.
Server exits immediately after starting with npx
Ensure Node.js 18+ is installed (`node --version`). If the @paystack/mcp-server package is not found, try adding -y to force npx to install: `npx -y @paystack/mcp-server --api-key sk_test_...`
Agent makes API calls but amounts are incorrect
Paystack amounts are in the smallest currency unit (kobo for NGN, pesewas for GHS). Specify amounts clearly in your prompt (e.g. '50000 kobo = 500 NGN') or instruct the agent to convert before calling the API.
Frequently Asked Questions about Paystack
What is Paystack?
Paystack is a Model Context Protocol (MCP) server that paystack's mcp server for agents It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Paystack?
Install via npm with the command: npx -y @paystack/mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Paystack?
Paystack works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Paystack free to use?
Yes, Paystack is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Paystack Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Paystack? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Paystack in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Paystack?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.