paystack-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Optional. HTTP listen port when transport is http. Default 3000. | |
| MCP_TRANSPORT | No | Optional. Transport to use: stdio or http. Default stdio. --http also selects HTTP. | |
| PAYSTACK_CONTACT | No | Optional. Contact string included in the User-Agent. | |
| PAYSTACK_BASE_URL | No | Optional. Paystack API origin only. Defaults to https://api.paystack.co. http is allowed only for a loopback host. A live key is refused when the base URL is loopback. | |
| PAYSTACK_PER_MINUTE | No | Optional. Local request-per-minute cap. Default 60. Paystack 429 responses are returned and not retried. | |
| PAYSTACK_SECRET_KEY | Yes | Required Paystack secret key. Accepts sk_test_…, or sk_live_… only when PAYSTACK_ALLOW_LIVE_KEY is exactly true. pk_ public keys and rk_ restricted keys are refused. | |
| PAYSTACK_TIMEOUT_MS | No | Optional. Per-request timeout in milliseconds. Default 20000. | |
| PAYSTACK_ALLOW_WRITES | No | Optional. Must be exact true or every write and money action is a preview. Default off. | |
| PAYSTACK_CACHE_TTL_SEC | No | Optional. Cache GET responses for this many seconds. Default 0. Payments remain uncached unless this is set. | |
| PAYSTACK_ALLOW_LIVE_KEY | No | Optional. Must be the exact string true before an sk_live_ key is accepted. Default off; values like 1, yes, and TRUE do not enable it. | |
| PAYSTACK_ALLOW_MONEY_MOVEMENT | No | Optional. Must be exact true or money actions stay a preview even when writes are enabled. Default off. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| paystack_balanceC | paystack_balance. Actions: balance (read), ledger (read). Read-only. Amounts are positive integers in subunits. |
| paystack_catalogC | paystack_catalog. Actions: list_subaccounts (read), fetch_subaccount (read), list_plans (read), fetch_plan (read), list_subscriptions (read), fetch_subscription (read), list_products (read), fetch_product (read), list_pages (read), fetch_page (read). Read-only. Amounts are positive integers in subunits. |
| paystack_customersB | paystack_customers. Actions: list (read), fetch (read), create (write), update (write), validate (write), set_risk_action (write). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_disputesA | paystack_disputes. Actions: list (read), fetch (read), transaction (read), export (read), update (write), evidence (write), resolve (write). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_invoicesB | paystack_invoices. Actions: list (read), fetch (read), create (write), update (write), verify (read), notify (write), finalize (write), archive (write), totals (read). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_lookupsC | paystack_lookups. Actions: banks (read), resolve_account (read), countries (read), states (read), verify_account (read). Read-only. Amounts are positive integers in subunits. |
| paystack_recipientsB | paystack_recipients. Actions: list (read), fetch (read), create (write), update (write), delete (write). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_refundsA | paystack_refunds. Actions: list (read), fetch (read), create (money). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_settlementsC | paystack_settlements. Actions: list (read), transactions (read). Read-only. Amounts are positive integers in subunits. |
| paystack_transactionsB | paystack_transactions. Actions: list (read), fetch (read), verify (read), timeline (read), totals (read), export (read), initialize (money), charge_authorization (money), partial_debit (money). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_transfersA | paystack_transfers. Actions: list (read), fetch (read), verify (read), initiate (money), finalize (money), bulk (money). Writes need confirm:true and PAYSTACK_ALLOW_WRITES=true. Money actions also need PAYSTACK_ALLOW_MONEY_MOVEMENT=true. Otherwise this is a preview and no request is sent. Amounts are positive integers in subunits. |
| paystack_webhookA | Verify an x-paystack-signature header locally. HMAC-SHA512 of the raw body with the configured secret key, compared in constant time. No network call. The key is never returned. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Tools are cleanly partitioned by resource domain (transactions, transfers, refunds, customers, disputes, etc.), so an agent can map intent to tool easily. There is minor overlap where 'verify' appears in transactions, invoices, transfers, and lookups, and where catalog bundles subscriptions/plans/products/pages/subaccounts, but descriptions make the target clear.
Every tool follows the same paystack_<resource> snake_case convention with a consistent prefix. The action-level verbs (list, fetch, create, update, verify) are applied uniformly inside each tool, giving a predictable structure throughout.
Twelve resource-grouped tools sit squarely in the well-scoped range, and each earns its place by covering a distinct Paystack domain. The grouping into action-dispatched tools keeps the count compact without omitting major areas.
Core money and lifecycle flows are covered: transactions, transfers, refunds, invoices, recipients, disputes, settlements, customers, plus webhook signature verification. The main gap is that paystack_catalog is read-only, so plans, products, pages, subaccounts, and subscriptions cannot be created or updated, and payment-page creation is absent.