Hosted MCP integration
Handles Paystack Payments API for processing transactions, charges, subscriptions, refunds, disputes, virtual accounts, and customer authorizations. Supports payment initialization, verification, and management for secure payment workflows and status tracking.
Give your agent access to the enabled tools in this release, including:
Connect to any agent following the individual agent's MCP documentation
Installation requires a ToolPlane account. Provider authorization is configured separately with your own credentials. Available operations depend on the permissions granted by your provider account.
Verified 2026-11-09. This has been tested with almost all the available Agents out there.
Only the tools listed for this release are included. Review the verification notes and enable the operations appropriate for your use case. Future releases do not automatically change an installed copy.
Initial release
This listing is published on ToolPlane. The provider name identifies the connected service; inclusion in the registry does not by itself imply provider endorsement. The source release, supported tools and verification notes are shown here so you can assess it before installing.
Create a new transaction with details like email, amount, currency, reference, callback URL, plan, invoice limit, and metadata.
{
"request": {
"email": "customer@example.com",
"amount": "10000",
"currency": "NGN",
"reference": "toolplane-payment-0001"
}
}Check the status and validity of a transaction using its unique reference ID.
Retrieve a paginated list of transactions filtered by date, customer, terminal ID, status, and amount.
Retrieve detailed information for a specific transaction using its unique ID.
Charge a payment using a reusable authorization with details like email, amount, currency, reference, and optional metadata and channels.
Retrieve the detailed timeline of a transaction using its ID or reference.
Retrieve transaction totals with optional pagination and date range filters.
Export transaction data with filters for date range, customer, status, currency, amount, and pagination options.
Partially debit a transaction authorization using authorization code, amount, currency, email, reference, and minimum amount parameters.
Create a payment charge with details like email, amount, currency, reference, metadata, device ID, split code, and subaccount.
Submit a charge PIN using the provided reference and PIN to authorize the transaction.
Submit a one-time password (OTP) to verify and complete a payment using the provided reference and OTP code.
Submit a phone number with a reference to initiate a charge request.
Submit a charge request with a reference ID and the user's birthday date.
Submit billing address details including reference, address, city, state, and zipcode for charge processing.
Retrieve the status of a pending charge using its reference ID.
Retrieve paginated bulk charge batches filtered by date range with optional page and per-page limits.
Start a bulk payment process by submitting a request to charge multiple accounts simultaneously.
Retrieve details of a bulk charge batch using its ID or code.
Retrieve charges from a batch using its ID or code, with optional filters for pagination, date range, and status.
Pause a bulk charge batch using its batch code.
Resume a paused bulk charge batch using the specified batch code.
Retrieve a paginated list of payment plans filtered by status, interval, and amount.
Create a payment plan with details like name, amount, interval, description, currency, invoice limits, and options to send invoices or SMS.
Retrieve detailed information about a payment plan using its ID or code.
Update a payment plan's details including name, amount, interval, description, notifications, and currency by plan ID or code.
Retrieve a paginated list of subscriptions, with optional filters for customer and plan details.
Create a subscription by providing customer details, plan, authorization, and start date.
Retrieve detailed subscription information using a subscription ID or code.
Activate a subscription using a provided code and authentication token.
Disable a subscription using the provided code and authentication token.
Generate a secure link to update the subscription details using the provided subscription code.
Send an email with a subscription update link using the provided subscription code.
Retrieve a paginated list of transaction splits with optional filters for date range, name, status, and sorting.
Create a transaction split with specified name, type, currency, subaccounts, and bearer details via a POST request.
Retrieve detailed information about a specific transaction split using its unique ID.
Update a transaction split by ID with new name, status, bearer type, and bearer subaccount details.
Add or update a subaccount's share in a revenue split by specifying the split ID, subaccount, and share amount.
Remove a specified subaccount from a split by its ID.
Retrieve a paginated list of subaccounts with optional date range filters.
Create a new subaccount with default settings via a POST request to the subaccount endpoint.
Retrieve detailed information about a subaccount using its ID or code.
Update a subaccount's details using its ID or code, including business name, bank info, contact details, and description.
Retrieve a list of dedicated virtual accounts filtered by status, currency, provider, bank, or customer.
Create a dedicated virtual account with customer details, preferred bank, subaccount, split code, and contact information.
Assign a dedicated virtual account using user details including name, email, phone, bank info, account number, BVN, and bank code.
Retrieve details of a specific dedicated virtual account using its unique ID.
Deactivate a dedicated virtual account by its unique ID.
Retrieve transaction details for a dedicated account using account number, provider identifier, and date.
Split a customer's dedicated account by subaccount, split code, and preferred bank via a POST request.
Delete the split configuration for a dedicated account using the account number.
Retrieve a list of available providers offering dedicated accounts.
Initialize a card preauthorization by providing payment details, customer email, amount, currency, reference, callback URL, metadata, and optional split info.
Capture a specified amount of preauthorized funds using reference and currency details.
Reserve funds on a reusable payment authorization using email, amount, authorization code, currency, and reference details.
Check the status of a preauthorization using its reference ID.
Release preauthorized funds using a reference identifier to free reserved amounts.
Retrieve a paginated list of preauthorizations filtered by date, customer, status, and amount.
Retrieve a paginated list of registered Apple Pay domains with optional cursor-based navigation.
Register a domain for Apple Pay by submitting the domain name via a POST request.
Remove a registered Apple Pay domain by specifying its domain name.
POST request to requery the status of a payment charge using the provided reference ID.
Retrieve a paginated list of disputes filtered by date range, transaction ID, and status.
Retrieve detailed information about a specific dispute using its unique ID.
Update a dispute by ID, modifying refund amount and uploaded file details.
Retrieve a list of disputes associated with a specific transaction by its ID.
Submit evidence for a dispute by providing customer info, service details, delivery address, and delivery date.
Retrieve a secure upload URL to attach a file to a specific dispute using its ID and the upload filename.
Resolve a dispute by providing resolution details, message, refund amount, evidence, and optional uploaded file using the dispute ID.
Retrieve a filtered list of disputes with pagination and export options based on date range, transaction ID, and status.
Retrieve a paginated list of refunds filtered by date range, transaction ID, currency, or reference number.
Initiate a refund by specifying transaction details, amount, currency, and optional customer and merchant notes with a reference.
Retry a refund by submitting customer bank details using the refund ID and account information.
Retrieve detailed information about a specific refund using its unique ID.
Retrieve a paginated list of customers with optional date range filters for precise results.
Create a new customer with email, first name, last name, phone, and optional metadata details.
Retrieve customer details using their email or unique code identifier.
Update a customer's details using their identifier, including first name, last name, phone, and additional metadata.
Verify a customer's identity using personal details and banking information for accurate validation.
Assign a specific risk action to a customer by providing their identifier and the desired risk action.
Initialize reusable direct-debit authorization by providing customer email, channel, callback URL, account, and address details.
Check if a customer authorization request identified by a reference is valid and approved.
Set up direct debit for a customer using their ID, bank account, and address details.
Activate a customer's direct debit mandate by triggering the associated activation charge using customer and authorization IDs.
Retrieve direct debit mandate authorizations for a specific customer by their ID.
Deactivate a customer's authorization using the provided authorization code.
Activate pending direct debit mandate charges for specified customers by providing their IDs.
Retrieve a paginated list of mandate authorizations filtered by status, with optional cursor-based navigation.
Retrieve a list of payment banks and providers filtered by country, currency, type, and pagination options.
Retrieve a list of address verification states for a specified country.