# PiggyVest Business MCP by usefulapi

> PiggyVest Business MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server to read and move money in PiggyVest Business from AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI, self-hosted
- **Website:** https://usefulapi.io/piggyvest-business-api/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/piggyvest-business-api
- **MCP Registry name:** io.usefulapi/piggyvest-business-api
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The server gives an AI client access to a PiggyVest Business account through 21 tools covering wallets, funding accounts, interest, bank lookups, transactions and scheduled payments. Access is granted by logging in with your PiggyVest Business secret key over OAuth, so nothing needs to be installed locally or placed in a config file.

Read tools let you list wallets and balances, trace transactions by status or reference, and resolve a bank account name before paying it. Write tools can create wallets and customers, reserve virtual accounts, transfer funds between wallets or to banks, and schedule or cancel recurring payments. Transfers and scheduled payments require explicit confirmation, and the README says bank payments return a processing status that should be checked by reference rather than retried.

The server is aimed at finance teams that pay out and reconcile PiggyVest Business API wallets, and at developers who want to use the account from Claude, ChatGPT, Cursor, VS Code or Codex. It is an independent service run by usefulapi and is not affiliated with PiggyVest.

## Features

- **Wallet and balance lookup:** Lists API wallets with total balances and reads a single wallet with its interest rates and funding account numbers.
- **Transaction tracing:** Filters transactions by wallet, status, direction, category and dates, and checks individual transfers by reference.
- **Payee name check:** Lists supported bank codes and resolves an account holder name before a bank transfer.
- **Confirmed money movement:** Transfers and scheduled payments need confirm set to true, and the server reports them as processing until checked.
- **Scheduled payment control:** Creates one-time or recurring payments from a wallet and cancels or reactivates them.
- **Usage metering and upgrades:** Reports usage against the plan limit and returns Stripe Checkout links for Pro or Pro+ plans.

## Good for

- Check API wallet balances before running a batch of payouts
- Find failed transactions from the past week and confirm their status by reference
- Verify a bank account name before sending a transfer
- Review interest accrued on a wallet for a month-end reconciliation
- Schedule or stop a recurring payment from a wallet

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http piggyvest-business-api https://piggyvest-business-api.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://piggyvest-business-api.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "piggyvest-business-api": {
      "url": "https://piggyvest-business-api.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "piggyvest-business-api": {
      "type": "http",
      "url": "https://piggyvest-business-api.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "piggyvest-business-api": {
      "serverUrl": "https://piggyvest-business-api.usefulapi.io/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://piggyvest-business-api.usefulapi.io/mcp
```

Enter a Name (for example "PiggyVest Business MCP by usefulapi"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "piggyvest-business-api": {
      "type": "http",
      "url": "https://piggyvest-business-api.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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}.

## FAQ

### Is this an official PiggyVest Business product?

No. The content states usefulapi is an independent service and is not affiliated with or endorsed by PiggyVest Business.

### What do I need to connect?

The login page asks for your PiggyVest Business secret key, which is found in the PiggyVest Business dashboard under API keys.

### Can the AI change my PiggyVest Business data?

Yes, if you approve it. Seven of the 21 tools can create or change data, and the rest are marked read-only.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/mo or $90/yr for 10,000 calls, and Pro+ is $39/mo or $390/yr for 100,000 calls.

### Is PiggyVest Business MCP by usefulapi free?

PiggyVest Business MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add PiggyVest Business MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http piggyvest-business-api https://piggyvest-business-api.usefulapi.io/mcp

### What are the best alternatives to PiggyVest Business MCP by usefulapi?

The closest alternatives to PiggyVest Business MCP by usefulapi are Vestiarion, Razorpay and SendPay free business calculators.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Vestiarion](https://ai-powered.com/mcp/vestiarion): Vestiarion is an MCP server for finance and payments.
- [Razorpay](https://ai-powered.com/mcp/razorpay): Razorpay is an open-source MCP server for finance and payments.
- [SendPay free business calculators](https://ai-powered.com/mcp/sendpay-free-business-calculators): SendPay free business calculators is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/piggyvest-business-mcp-by-usefulapi
