# mcp-picpay

Connects AI agents to the PicPay Business API. It handles Pix QR generation, checkout orders, recurring subscriptions, and merchant fund transfers.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/picpay
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-picpay

## What it does

The server provides 20 tools covering the PicPay Checkout and Recurrency APIs. Your assistant can initiate payments, return checkout links, or generate Pix QR codes. It also checks wallet balances in BRL. For payouts, the server handles single or batch B2P transfers.

Authentication requires setting `PICPAY_TOKEN` and `PICPAY_SELLER_TOKEN` environment variables. The seller token lets you verify incoming webhooks with `validate_notification`. Because the package is at version `0.1.0-alpha.1`, verify subscription and plan schemas against live endpoints before pushing to production.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PICPAY_TOKEN`, `PICPAY_SELLER_TOKEN`, `PICPAY_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env PICPAY_TOKEN=<PICPAY_TOKEN> --env PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> --env PICPAY_BASE_URL=<PICPAY_BASE_URL> --transport stdio picpay -- npx -y @codespar/mcp-picpay
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add picpay --env PICPAY_TOKEN=<PICPAY_TOKEN> --env PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> --env PICPAY_BASE_URL=<PICPAY_BASE_URL> -- npx -y @codespar/mcp-picpay
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "picpay": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-picpay"
            ],
            "env": {
                "PICPAY_TOKEN": "<PICPAY_TOKEN>",
                "PICPAY_SELLER_TOKEN": "<PICPAY_SELLER_TOKEN>",
                "PICPAY_BASE_URL": "<PICPAY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "picpay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-picpay"
            ],
            "env": {
                "PICPAY_TOKEN": "<PICPAY_TOKEN>",
                "PICPAY_SELLER_TOKEN": "<PICPAY_SELLER_TOKEN>",
                "PICPAY_BASE_URL": "<PICPAY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PICPAY_TOKEN=<PICPAY_TOKEN> -e PICPAY_SELLER_TOKEN=<PICPAY_SELLER_TOKEN> -e PICPAY_BASE_URL=<PICPAY_BASE_URL> picpay npx -y @codespar/mcp-picpay
```
Replace <…> with your own values

## When to use it
- Generate Pix QR codes and checkout payment links
- Query payment status by reference ID or issue refunds
- Send batch B2P transfers to multiple PicPay accounts
- Configure subscription plans and enroll buyers
- Verify webhook payloads using the seller token

## Example prompts
- Create a checkout payment for order `order-42` and return the Pix QR code
- Check the merchant wallet balance and list recent transactions for today
- Submit a batch B2P transfer to the recipient list using `create_batch_payment`

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md