PicPay

What your agent can do

PicPay gives your agent 20 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →create_payment — Create a PicPay checkout payment. Returns paymentUrl (redirect the buyer to the PicPay app / web) and qrcode (content + base64 image). The buyer pays inside PicPay; your callbackUrl receives the status update. value is in BRL as a decimal number (e.g. 20.50).
• →get_payment_status — Get the status of a payment by referenceId. Typical statuses: created, expired, analysis, paid, completed, refunded, chargeback.
• →cancel_payment — Cancel a PicPay order. If the order is unpaid, it is voided. If already paid, this triggers a refund (requires merchant account balance to cover).

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });

Install

$ npm install @codespar/mcp-picpay@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "picpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-picpay@alpha"
      ],
      "env": {
        "PICPAY_TOKEN": "<your_picpay_token>",
        "PICPAY_SELLER_TOKEN": "<your_picpay_seller_token>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try create_payment first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions