Picpay MCP Server

mcp-picpay is an MCP server that exposes 20 tools to an agent, covering payment, plan, read & search.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Picpay

before you install - you'll need

Set PICPAY_TOKEN, PICPAY_SELLER_TOKEN, MCP_HTTP before connecting. PICPAY_BASE_URL is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-picpay

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-picpay"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-picpay - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Picpay can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a PicPay checkout payment, get the status of a payment by referenceId, cancel a PicPay order, and create a subscription plan (Recurrency API).

Capability map

Tools grouped from the project's README - what Picpay lets an agent do.

Payment

6 tools - e.g. Create a PicPay checkout payment.; Get the status of a payment by referenceId.; Cancel a PicPay order.

create_payment · get_payment_status · cancel_payment · refund_payment · create_batch_payment · create_payment_link

Plan

3 tools - e.g. Create a subscription plan (Recurrency API).; Update an existing subscription plan.; Delete a subscription plan.

create_plan · update_plan · delete_plan

read & search

3 tools - e.g. List all subscription plans registered for this merchant.; List merchant transactions (payments and transfers) within a date range.; Retrieve the merchant's current PicPay wallet balance (available and…

list_plans · list_transactions · get_wallet_balance

Subscription

3 tools - e.g. Enroll a buyer in a subscription plan.; Retrieve a subscription by id.; Cancel an active subscription.

create_subscription · get_subscription · cancel_subscription

B2p

2 tools - e.g. Create a Business-to-Person (B2P) transfer: push funds from the merchant wallet to a PicPay user identified...; Get the status of a B2P transfer by referenceId.

create_b2p_transfer · get_b2p_transfer

Generate

2 tools - e.g. Generate a static PicPay Pay QR code for in-store / reusable use.; Generate a dynamic PicPay Pay QR code with a fixed amount and optional expiration.

generate_static_qrcode · generate_dynamic_qrcode

Validate

1 tool - e.g. Verify that an incoming webhook callback came from PicPay by comparing the x-seller-token header against PI...

validate_notification

04 · Who maintains Picpay

mcp-picpay is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: other - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-picpay (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-picpay

06 · Picpay FAQ

Is Picpay still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Picpay do?

With this server connected, an agent can create a PicPay checkout payment, get the status of a payment by referenceId, cancel a PicPay order, and create a subscription plan (Recurrency API).

How do I install Picpay?

Run `npx -y @codespar/mcp-picpay`. The README documents 4 environment variables (PICPAY_TOKEN, PICPAY_SELLER_TOKEN, PICPAY_BASE_URL…) to set first. Set PICPAY_TOKEN, PICPAY_SELLER_TOKEN, MCP_HTTP before connecting. PICPAY_BASE_URL is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Picpay run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Picpay

Alternatives to Picpay

Maintained other servers if Picpay isn't the fit.

More MCP servers to compare · Rapyd · Safrapay · Transbank · Ucp · Wise

More JavaScript MCP servers · Pix Bcb · Rede · Rinne · see all