# Paystack MCP > Paystack connects your account directly to any AI client. You stop logging into dashboards and start talking to your payments system. This MCP lets you manage everything from checking transaction statuses and listing customers to tracking subscriptions and running refunds—all through natural conversation. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** online-payments, transaction-verification, customer-management, subscription-billing, fintech-api, africa-payments ## Description Managing online revenue usually means hopping between Stripe, the bank portal, and the support CRM just to answer one simple question: Did this customer pay? With this Paystack MCP, your agent handles that. You simply ask your AI client a query about payments or accounts, and it pulls the data directly from Paystack. Need to know if a specific transaction went through last week? Ask. Want to see how many active subscriptions you have running right now? Just prompt it. It gives you real-time details on customer profiles, current billing plans, or recent transfers, allowing your agent to act as your financial operations manager without ever leaving the chat window. You get full control over listing transactions, verifying payment status, and reviewing refund records—all guided by the Vinkius catalog. ## Tools ### get_customer Retrieves the full details for a specific customer profile in Paystack. ### get_subscription Pulls up all information related to one active or past subscription. ### get_transaction Fetches the complete record and metadata for a single, specific transaction ID. ### list_customers Gives you a list of all customers registered in your Paystack account. ### list_plans Provides a comprehensive view of every payment plan currently configured. ### list_refunds Lists all recent refunds that have been processed through the system. ### list_subscriptions Retrieves a list of all active and archived subscriptions you manage. ### list_transactions Generates a paginated list of recent transactions that occurred on the account. ### list_transfers Provides an overview and list of all money transfers initiated from Paystack. ### verify_transaction Checks the current, definitive status (success or failure) of a specific transaction reference. ## Prompt Examples **Prompt:** ``` Check the status of transaction reference 'ref_789456'. ``` **Response:** ``` Transaction 'ref_789456' was successful. The customer paid 5,000 NGN on Oct 24, 2026. ``` **Prompt:** ``` List the last 5 customers registered in our Paystack account. ``` **Response:** ``` I've retrieved the latest customers. Here are the 5 most recent signups, including their names, emails, and Paystack customer codes. ``` **Prompt:** ``` How many active subscriptions do we currently have? ``` **Response:** ``` You currently have 124 active subscriptions across various plans. Would you like a breakdown by plan type? ``` ## Capabilities ### Check transaction history List all payments that have occurred, or check the detailed status of any single reference ID. ### Manage customer records Retrieve lists of customers and fetch specific profiles to review their payment activity and metadata. ### Audit recurring revenue Monitor all active subscriptions, view billing plans, and track past renewal cycles. ### Process financial reconciliation List recent refunds and outbound transfers to keep your books accurate for accounting purposes. ### View payment configurations See all the configured billing plans and their associated settings within Paystack. ## Use Cases ### Customer support needs immediate proof of payment. A customer tweets, 'My order hasn't shipped.' The support agent asks the AI client, 'Check transaction status for reference XYZ.' The MCP uses `verify_transaction` and immediately replies: 'Success. Payment of $50 was received on Monday.' The issue is resolved in one chat exchange. ### The finance team needs to reconcile last month's payments. Instead of exporting 12 separate CSV files, the analyst asks the AI client to 'List all transactions and all refunds for June.' The MCP uses `list_transactions` followed by `list_refunds`, compiling a single, unified data set in seconds. ### An e-commerce owner needs to check a high-value account. The agent asks the AI client to 'Show me all details on customer John Doe.' The MCP uses `get_customer` and provides not only contact info but also their payment history, allowing the owner to manage relationships better. ### A developer needs to audit subscription billing. The dev asks the AI client, 'What are our top three active plans?' The MCP uses `list_plans` and then can pull detailed data by running `list_subscriptions`, ensuring there aren't any orphaned or outdated payment configurations. ## Benefits - Stop manually checking dashboards. You can use the `verify_transaction` tool to check a payment's real-time status immediately, without logging into any other system. - Gain full visibility over customer finances by listing all users using `list_customers` and then getting deep details on one user with `get_customer`. - Simplify billing audits. You can use `list_subscriptions` to see everything that's active, and then run `get_subscription` for a detailed breakdown of any single plan. - Keep your books clean by running `list_refunds` or `list_transfers`. This lets you quickly gather the necessary records needed for financial reporting. - Handle payments like a pro. You can use the MCP to view all available payment plans using `list_plans`, which helps understand what options are available to your customers. ## How It Works The bottom line is that you treat your payment gateway like another API endpoint—you just talk to it instead of writing code to call it. 1. Subscribe to this MCP on Vinkius and provide your specific Paystack Secret Key (sk_...). 2. Connect it to your preferred AI client, like Cursor or Claude. 3. Use natural language prompts to ask questions about payments. Your agent runs the necessary functions and delivers structured data right in the chat. ## Frequently Asked Questions **How do I check transaction status with Paystack MCP?** You use the `verify_transaction` tool by giving it the specific reference ID. The agent confirms immediately if the payment succeeded or failed, and why. **Can Paystack MCP list all my customers?** Yes, you can run `list_customers` to get a full roster of users. From there, you can narrow down details for one person using `get_customer`. **Does Paystack MCP help with recurring billing issues?** You can track this by listing all active plans via `list_plans`, and then running `list_subscriptions` to see which customers are currently billed. **What is the difference between list_transactions and verify_transaction in Paystack MCP?** `list_transactions` gives you a paginated history (a list of many). `verify_transaction` checks one single, specific transaction status right now. **Is Paystack MCP useful for accounting reconciliation?** Absolutely. You can use `list_refunds` and `list_transfers` to pull the exact data needed to reconcile your financial records at month-end.