io.usefulapi/piggyvest-business-api · v1.0.2 · crypto-web3
PiggyVest Business MCP by usefulapi is healthy: it completed an MCP handshake in 308 ms and exposes 17 tools.
Read wallets and transactions, check payees, and send or schedule transfers in PiggyVest Business.
Endpoint: https://piggyvest-business-api.usefulapi.io/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 17 |
| Latency | 308 ms |
| Last checked (UTC) | 2026-11-07T15:40:26.511Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-07T15:40:26.511Z | Healthy | 308 |
piggyvest_list_wallets | List the business's API wallets with the total balance (kobo) and a page of wallets. Good first call to find wallet ids. GET /api/v1/wallet/api/wallet-type. |
piggyvest_get_wallet | Get one wallet: name, status, balance (kobo), interest rates and virtual account id. GET /api/v1/wallet/{wallet_id}. |
piggyvest_get_wallet_accounts | List the bank account numbers that fund a wallet (virtual accounts with bank names). GET /api/v1/wallet/{wallet_id}/accounts. |
piggyvest_get_wallet_interest | List stored interest accruals for a wallet over a date range (defaults to the current calendar month). GET /api/v1/wallet/interests/accrued/{wallet_id}. |
piggyvest_list_banks | List the banks supported for transfers, with each bank's code. Use the code as bankCode in piggyvest_transfer_to_bank. GET /api/v1/transfer/bank-list. |
piggyvest_name_enquiry | Check the account holder name for a bank account before a transfer. Use it to confirm the payee. GET /api/v1/transfer/name-enquiry. |
piggyvest_get_transaction_status | Check the status (success, pending or failed) of a transfer by the reference you sent. Use it after a transfer to confirm the final result. GET /api/v1/transaction/verify. |
piggyvest_get_transaction | Get one transaction by its PiggyVest id: amount, fee, status, wallets and balances after the move. GET /api/v1/transaction/{transaction_id}. |
piggyvest_list_transactions | List the business's transactions, newest first, with filters for wallet, status, direction, category and dates. GET /api/v1/transaction. |
piggyvest_list_customers | List the customers created through this API, with optional filters by your own id or the PiggyVest customer id. GET /api/v1/customers. |
piggyvest_create_wallet | Create a new API wallet for a customer. Creation is asynchronous: the reply is only a wallet id, and the wallet is ready after a few minutes. POST /api/v1/wallet/sub-account. |
piggyvest_create_customer | Create a business customer and its default wallet. Sends personal identity data (BVN) to PiggyVest for verification: send only what the customer agreed to share. POST /api/v1/customers. |
piggyvest_reserve_account | Reserve a bank account number for a wallet. A regular account stays active; a disposable account expires after the expiry minutes. POST /api/v1/wallet/reserve-account. |
piggyvest_transfer_between_wallets | MOVES MONEY: transfer kobo from one of this business's wallets to another. Needs confirm=true. The reply is 202 (processing): check the result with piggyvest_get_transaction_status. Do not retry with the same reference; check it first. POST /api/v1/transfer/wallet. |
piggyvest_transfer_to_bank | MOVES MONEY: send kobo from a wallet to an external bank account. Call piggyvest_name_enquiry first. Needs confirm=true. The reply is 202 (processing): check the result with piggyvest_get_transaction_status. Do not retry with the same reference; check it first. POST /api/v1/transfer/bank. |
piggyvest_schedule_payment | SCHEDULES A FUTURE PAYMENT: a one-time or recurring transfer from a wallet to a wallet or bank account. Needs confirm=true. Cancel it later with piggyvest_set_schedule_payment_active. POST /api/v1/transfer/schedule-payment. |
piggyvest_set_schedule_payment_active | Set a scheduled payment active or inactive. is_active=false cancels it (no more runs). is_active=true reactivates it and needs confirm=true. A payment whose end date has passed cannot be reactivated. PATCH /api/v1/transfer/schedule-payment/{schedule_payment_id}. |