Paystack MCP server

Connect Paystack to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Paystack MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list dedicated virtual accounts tool in Paystack
  • Use the update plan tool in Paystack
  • Use the create refund tool in Paystack
  • Use the resolve dispute tool in Paystack
  • Use the list plans tool in Paystack
  • Use the list customers tool in Paystack

Supported Tools

list_dedicated_virtual_accounts

List Dedicated Virtual Accounts

Retrieve a list of dedicated virtual accounts on your integration. Filter by active status, currency, provider, or customer.

update_plan

Update Plan

Update recurring billing parameters. Paystack applies changes to existing subscriptions by default; explicitly set updateExistingSubscriptions=false to affect only future subscriptions.

create_refund

Create Refund

Create a refund for a completed transaction. You can refund the full amount or a partial amount. Refunds go through statuses: pending, processing, processed, success/failed.

resolve_dispute

Resolve Dispute

Resolve a transaction dispute by providing evidence or accepting the dispute with a refund.

list_plans

List Plans

Retrieve a paginated list of subscription plans on your integration. Filter by status, interval, or amount.

list_customers

List Customers

Retrieve a paginated list of customers on your integration. Supports filtering by date range.

charge_authorization

Charge Authorization

Charge a customer's saved payment authorization from a previous successful transaction. Useful for recurring payments, one-click checkout, and billing customers without redirecting them. Amounts are in the **smallest currency unit**.

list_disputes

List Disputes

Retrieve a paginated list of transaction disputes. Filter by status, transaction, or date range.

list_payment_pages

List Payment Pages

Retrieve a paginated list of payment pages on your integration.

list_subaccounts

List Subaccounts

Retrieve a paginated list of subaccounts on your integration.

list_banks

List Banks

Retrieve the list of supported banks and their codes. Use this to find the bank code needed for verifying accounts and creating transfer recipients.

get_customer

Get Customer

Fetch details for a single customer by email or customer code. Returns full customer profile including transactions and subscriptions.

update_customer

Update Customer

Update an existing customer's details. Can modify name, phone, and metadata. Can also whitelist or blacklist a customer by setting the risk action.

list_refunds

List Refunds

Retrieve a paginated list of refunds on your integration. Filter by reference, currency, or date range.

list_payment_requests

List Payment Requests

Retrieve a paginated list of payment requests/invoices. Filter by customer, status, currency, or date range.

create_customer

Create Customer

Create a new customer record on your Paystack integration. Customers are used to track payment history and manage recurring billing.

list_transactions

List Transactions

Retrieve a list of transactions on your integration. Supports filtering by status, customer, date range, and amount. Returns paginated results.

create_payment_page

Create Payment Page

Create a hosted payment page that can be shared via link. Useful for collecting payments without building a custom checkout. Amount is in the **smallest currency unit**. Leave amount empty to let the customer enter an amount.

list_transfers

List Transfers

Retrieve a paginated list of transfers. Filter by date range.

create_subaccount

Create Subaccount

Create a subaccount for splitting payments. Subaccounts represent third-party businesses or vendors that receive a portion of each transaction.

initiate_transfer

Initiate Transfer

Send money to a bank account or mobile money number. You must first create a transfer recipient, then use their recipient code here. The source is always "balance". Amounts are in the **smallest currency unit**.

disable_subscription

Disable Subscription

Stop future renewal of a subscription; it can remain non-renewing until the current billing period ends. Requires the subscription code and the email token (returned when the subscription was created or can be found in subscription details).

update_payment_page

Update Payment Page

Update an existing payment page's name, description, amount, or active status.

create_plan

Create Plan

Create a subscription plan that defines recurring billing parameters. Plans specify the amount, currency, and billing interval for automatic charges. Amounts are in the **smallest currency unit** (e.g., kobo for NGN).

verify_bank_account

Verify Bank Account

Resolve and verify a bank account number. Returns the account name for confirmation before creating a transfer recipient. Use the List Banks tool to get the bank code.

create_transfer_recipient

Create Transfer Recipient

Create a transfer recipient (bank account or mobile money) to receive funds. The recipient code can then be used to initiate transfers.

resolve_card_bin

Resolve Card BIN

Look up card details using the first 6 digits (BIN) of a card number. Returns the card brand, type, issuing bank, and country.

create_subscription

Create Subscription

Subscribe a customer to an existing plan. The customer must have a valid payment authorization (from a previous transaction). Supports card and direct debit (Nigeria).

initialize_transaction

Initialize Transaction

Initialize a new payment transaction on Paystack. Returns an authorization URL where the customer can complete payment, or use for programmatic charge flows. Amounts are in the **smallest currency unit** (e.g., kobo for NGN: NGN 100 = 10000).

create_payment_request

Create Payment Request

Create and send an invoice/payment request to a customer. Supports line items, tax, due dates, and notifications. Amounts are in the **smallest currency unit**.

list_subscriptions

List Subscriptions

Retrieve a paginated list of subscriptions. Filter by customer or plan.

list_settlements

List Settlements

Retrieve a paginated list of settlements (payouts) made by Paystack to your bank account. Provides insight into when funds were settled and for how much.

get_subscription

Get Subscription

Fetch details for a single subscription by its ID or code. Returns the subscription's status, plan, customer, management token, and next payment date.

enable_subscription

Enable Subscription

Re-enable a previously disabled subscription. Requires the subscription code and the email token.

verify_transaction

Verify Transaction

Verify the status of a transaction using its reference. Returns full transaction details including payment status, amount and selected customer metadata.

create_dedicated_virtual_account

Create Dedicated Virtual Account

Create a dedicated virtual bank account (DVA) for a customer. All bank transfers to this account are automatically recorded as transactions from the customer. Available to eligible Nigerian and Ghanaian merchants; customer and bank eligibility apply.

archive_payment_request

Archive Payment Request

Archive a payment request and read back its archived flag. The request disappears from normal list and verification results; financial history is retained.

get_balance

Get Balance

Read the available transfer balance for each returned currency. Does not reserve funds or initiate a transfer.

verify_transfer

Verify Transfer

Read a transfer by its reference and return the observed provider status. Pending or OTP status is not delivery confirmation; test-mode success does not move real money.

list_transfer_recipients

List Transfer Recipients

List saved transfer beneficiaries and observed active states. Returns selected bank details and the provider continuation metadata; listing does not transfer funds.

delete_transfer_recipient

Delete Transfer Recipient

Deactivate a saved transfer beneficiary and read back its inactive state. Paystack retains the recipient and transfer history; this operation does not erase financial records.

Connect Paystack to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Paystack in Metorial. In your Metorial portal, enable the Paystack MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Paystack tools.

Run Paystack through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Paystack and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Paystack tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Paystack

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Technical notes for Paystack

Manage Paystack transactions, customers, plans, subscriptions, transfer beneficiaries, balances, refunds, settlements, payment pages and payment requests. Provision eligible subaccounts and dedicated virtual accounts, resolve disputes, verify bank accounts and inspect card BIN metadata. Financial operations can affect funds and retained history.

Frequently asked questions

Common questions about connecting Paystack to AI agents with Metorial.

  1. How many tools does the Paystack MCP server have?
    The Paystack MCP server exposes 41 tools, including List Dedicated Virtual Accounts, Update Plan, Create Refund. Each one is governed and traced through Metorial.
  2. Paystack exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Paystack MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Paystack and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Paystack MCP server yourself or use the hosted gateway.

Connect Paystack to production AI agents

See how Metorial gives your team governed access to Paystack, with tracing and security controls built in.