# Pin Payments MCP by usefulapi

> Pin Payments MCP by usefulapi is an MCP server for finance and payments. Read Pin Payments charges, refunds, balances, transfers and subscriptions without moving money. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/pin-payments/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/pin-payments
- **MCP Registry name:** io.usefulapi/pin-payments
- **Categories:** finance and payments
- **Listing updated:** 2026-11-13

## About

Read Pin Payments charges, refunds, balances, transfers and subscriptions without moving money.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pin-payments https://pin-payments.usefulapi.io/mcp
```

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

```sh
https://pin-payments.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "pin-payments": {
      "url": "https://pin-payments.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "pin-payments": {
      "type": "http",
      "url": "https://pin-payments.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pin-payments": {
      "serverUrl": "https://pin-payments.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pin-payments": {
      "type": "http",
      "url": "https://pin-payments.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `pinpayments_get_balance`: The current Pin Payments account balance: available (ready to transfer) and pending (available plus estimated funds from charges that have not settled yet), per currency, in the currency's base unit (cents for AUD). GET /balance.
- `pinpayments_list_charges`: List charges (card payments), 25 per page: amount (in the currency's base unit, e.g. cents for AUD), currency, description, payer email, status_message/success, total_fees, merchant_entitlement, amount_refunded, captured, settlement transfers, chargebacks flag, metadata. The card is shown only as scheme and last four digits. GET /charges.
- `pinpayments_search_charges`: Search charges by free text (description, email, metadata, cardholder name, currency, exact amount in the currency's base unit, exact charge/card/refund/customer token) and/or a created-date range. GET /charges/search.
- `pinpayments_get_charge`: One charge by token (ch_...), with fees, refunds total, settlement transfer state and chargeback flag. GET /charges/{token}.
- `pinpayments_list_charge_refunds`: All refunds issued against one charge. GET /charges/{token}/refunds.
- `pinpayments_list_refunds`: List all refunds, 25 per page: amount (in the currency's base unit), currency, charge token, status_message, error_message, created_at. GET /refunds.
- `pinpayments_get_refund`: One refund by token (rf_...). GET /refunds/{token}.
- `pinpayments_list_authorisations`: List card authorisations (held funds, not yet captured; they expire after seven days) with amount, amount_captured, amount_remaining and expired flags. GET /authorisations.
- `pinpayments_get_authorisation`: One authorisation by token (auth_...). GET /authorisations/{token}.
- `pinpayments_list_customers`: List stored customers, 25 per page: token, email, first_name, last_name, phone_number, company, notes and the primary card as scheme and last four digits. GET /customers.
- `pinpayments_get_customer`: One customer by token (cus_...). GET /customers/{token}.
- `pinpayments_list_customer_charges`: Charges made by one customer. GET /customers/{token}/charges.
- `pinpayments_list_customer_cards`: Cards stored for one customer, each shown only as scheme, last four digits and issuing country (no token, expiry or address). GET /customers/{token}/cards.
- `pinpayments_list_customer_subscriptions`: Subscriptions of one customer: state, plan, next billing date, active interval, cancellation time. GET /customers/{token}/subscriptions.
- `pinpayments_list_deposits`: List deposits made to the account (amount, currency, bank narration, available_at). GET /deposits.
- `pinpayments_get_deposit`: One deposit by token (dpo_...). GET /deposits/{token}.
- `pinpayments_list_transfers`: List transfers (payouts to bank accounts), 25 per page: status, amount, debits/credits, paid_at, reference, line item count, bank account (masked) and recipient. GET /transfers.
- `pinpayments_search_transfers`: Search transfers by token, description, amount or recipient details and/or a created-date range. GET /transfers/search.
- `pinpayments_get_transfer`: One transfer by token (tfer_...). GET /transfers/{token}.
- `pinpayments_list_transfer_line_items`: The ledger line items that make up one transfer (charge entitlements, fees, refunds, chargebacks). GET /transfers/{token}/line_items.
- `pinpayments_list_recipients`: List transfer recipients (name, email, masked bank account). GET /recipients.
- `pinpayments_get_recipient`: One recipient by token (rp_...). GET /recipients/{token}.
- `pinpayments_list_recipient_transfers`: Transfers paid to one recipient. GET /recipients/{token}/transfers.
- `pinpayments_list_disputes`: List chargeback disputes: category, status, amount, the disputed charge, evidence_required_by and the relevant evidence types. GET /disputes.
- `pinpayments_search_disputes`: Search disputes by status or exact charge token, optionally filtered by status. GET /disputes/search.
- `pinpayments_get_dispute`: One dispute by token (dis_...). GET /disputes/{token}.
- `pinpayments_get_dispute_activity`: The activity feed of one dispute (status changes, ledger entries such as chargeback fees and recoveries). GET /disputes/{token}/activity.
- `pinpayments_list_plans`: List subscription plans: name, amount, currency, interval, trial and setup amounts, subscription counts by state. GET /plans.
- `pinpayments_get_plan`: One plan by token (plan_...). GET /plans/{token}.
- `pinpayments_list_plan_subscriptions`: Subscriptions to one plan. GET /plans/{token}/subscriptions.
- `pinpayments_list_subscriptions`: List all subscriptions: state (trial, active, cancelling, cancelled), plan, customer, next_billing_date, active interval, cancelled_at. GET /subscriptions.
- `pinpayments_get_subscription`: One subscription by token (sub_...). GET /subscriptions/{token}.
- `pinpayments_get_subscription_ledger`: The ledger entries (credits and debits) of one subscription. GET /subscriptions/{token}/ledger.
- `pinpayments_list_events`: The account's event log (charge.captured, refund.created, dispute.updated, ...), each with the affected record (cards masked). GET /events.
- `pinpayments_get_event`: One event by token (evt_...). GET /events/{token}.

## FAQ

### How do I add Pin Payments MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http pin-payments https://pin-payments.usefulapi.io/mcp

### What are the best alternatives to Pin Payments MCP by usefulapi?

The closest alternatives to Pin Payments MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/pin-payments-mcp-by-usefulapi
