# PayPing [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/sepehr071/payping-mcp  
**GitHub Stars:** 1  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/payping

## Description
PayPing merchant account for agents: balance, sales, invoices; create invoices and payment links.

## Tools
Capabilities this server exposes over MCP:

- **payping_get_profile** — Account behind the token: username, name, contact, verification flags
- **payping_get_balance** — Wallet balance
- **payping_get_sales_summary** — Total sales, count and daily averages for a period (default last 30 days)
- **payping_list_transactions** — Payments in a date range, received or paid
- **payping_get_payment** — One payment by code, with its real status (paid and verified, cancelled, ...)
- **payping_list_withdrawals** — Settlements to your bank account
- **payping_get_withdrawal** — One settlement by code: IBAN, bank tracking number
- **payping_list_customers** — Saved customers, searchable
- **payping_get_customer** — One customer
- **payping_list_products** — Products (financial items), searchable
- **payping_get_product** — One product
- **payping_list_coupons** — Discount coupons
- **payping_get_coupon** — One coupon with buyer count and total
- **payping_list_invoices** — Invoices, filter by status or customer
- **payping_get_invoice** — One invoice with items and its pay page url
- **payping_create_customer** — Save a customer; returns its code
- **payping_create_product** — Create a product with a fixed or payer-set price
- **payping_create_payment_link** — Public pay page for a product: `https://ppng.ir/d/<product code>
- **payping_create_coupon** — Percent or Toman discount coupon
- **payping_create_invoice** — Invoice for a saved customer; returns its pay page `https://ppng.ir/v/<invoice code>
- **payping_send_invoice** — PayPing sends the invoice to the customer by SMS/email

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "payping": {
    "command": "uvx",
    "args": ["payping-mcp"],
    "env": {
      "PAYPING_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `PAYPING_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the PayPing MCP server does

The PayPing MCP server exposes an Iranian PayPing merchant account to MCP-compatible AI clients. It can retrieve account profile details, wallet balance, sales summaries, transactions, payment status, bank settlements, customers, products, discount coupons, and invoices. List operations support searching or filtering where PayPing provides those options, including invoice filters by status or customer.

The server also supports selected account changes. Agents can save customers, create products with fixed or payer-selected prices, generate product payment links, create discount coupons, create invoices for saved customers, and ask PayPing to send invoices by SMS or email. A typical invoice flow is to create or find a customer, create an invoice, and optionally send it. A product flow can create a product and then return a public payment page.

This belongs in the Finance & Fintech category for workflows that combine an agent with a merchant account. It is not a general payment-processing or payout interface: it cannot withdraw funds, refund or reverse payments, or delete records.

## How it works

The PayPing MCP server runs on the user’s machine as a standard stdio process and communicates with PayPing. Authentication uses a PayPing API token supplied through the environment. The token’s scopes control which read and write operations succeed, so a read-only token can be used when the agent should not change account data.

The server exposes 21 tools with the `payping_` prefix. Read tools return compact JSON. List responses contain no more than 50 items and include a total, so callers may need to apply search or date filters. Amounts are expressed in Toman, and dates use UTC.

Create and send operations should be confirmed with the user before execution. The server does not itself provide tools for taking raw payments, making payouts, or reversing payment activity.

## Setup and configuration

Install with `uvx payping-mcp`, provided `uv` and Python 3.10 or newer are available. Installing the package with `pip install payping-mcp` is another supported option. The required environment variable is `PAYPING_TOKEN`; `PAYPING_MCP_PROXY` can optionally specify an HTTP proxy.

Before connecting the server, create a token in the PayPing merchant dashboard and wait for approval. PayPing requires a complete merchant profile for token approval, and newly approved tokens may take about ten minutes to become usable. The token is shown only once when created. Configure only the scopes needed for the intended workflow, such as payment reads, customer access, product access, coupon access, or invoice access.

Claude Desktop, Claude Code, Cursor, and VS Code can use the stdio configuration. Other MCP clients can run the same command with the token in their environment.

## Tools and capabilities

- Read profile, balance, sales summaries, transactions, payment details, and withdrawals.
- Search or retrieve customers, products, coupons, and invoices.
- Create customers, products, payment links, coupons, and invoices.
- Send an invoice through PayPing by SMS or email.
- Pass returned customer, product, and invoice codes between related operations.

## Limitations and notes

Dashboard-based balance and sales-summary endpoints may reject API tokens even when other tools work. Token scopes can also cause individual tools to return authorization errors. A token with write scopes is needed for creation and invoice-sending operations; omitting those scopes leaves the account unchanged by this server.

The PayPing MCP server acts on the authenticated user’s own account. It does not provide deletion, withdrawal, refund, reversal, or raw payment-collection tools. Keep the token private and use the narrowest practical scope set.

_Full upstream README: https://allmcps.com/mcp/payping/readme_