ClaudeCodeMod
SubmitAdvertise

All shelves / MCP servers

io.github.codespar/mcp-picpay

io.github.codespar/mcp-picpay · 273 stars · TypeScript · MIT

MCP server MCP server for PicPay Business — BR digital wallet (60M+ users): checkout, Pix QR, subscriptions

Install

The repo has no one-line install. Follow its README.

Published as

  • npm@codespar/mcp-picpaystdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

NameSet asWhat it is
PICPAY_TOKENRequired · SecretEnv varPicPay merchant integration token (sent as x-picpay-token header)
PICPAY_SELLER_TOKENRequired · SecretEnv varPicPay seller token used to validate webhook callbacks (x-seller-token header)
PICPAY_BASE_URLOptionalEnv varPicPay ecommerce API base URL. Defaults to https://appws.picpay.com/ecommerce/public.

Files

packages/payments/picpay/README.md

@codespar/mcp-picpay

MCP server for PicPay Business — Brazilian digital wallet with 60M+ users.

PicPay's Checkout API lets merchants create a payment intent that the buyer completes inside the PicPay app, returning a redirect URL plus a Pix-style QR code. The Recurrency API adds subscription plans on top.

Tools (20)

Tool Purpose
create_payment Create a PicPay checkout payment.
get_payment_status Get the status of a payment by referenceId.
cancel_payment Cancel a PicPay order.
create_plan Create a subscription plan (Recurrency API).
list_plans List all subscription plans registered for this merchant.
update_plan Update an existing subscription plan.
delete_plan Delete a subscription plan.
create_subscription Enroll a buyer in a subscription plan.
get_subscription Retrieve a subscription by id.
cancel_subscription Cancel an active subscription.
validate_notification Verify that an incoming webhook callback came from PicPay by comparing the x-seller-token header against PI...
refund_payment Refund a paid PicPay order, optionally partially.
create_b2p_transfer Create a Business-to-Person (B2P) transfer: push funds from the merchant wallet to a PicPay user identified...
get_b2p_transfer Get the status of a B2P transfer by referenceId.
create_batch_payment Submit a batch of B2P transfers in a single request.
list_transactions List merchant transactions (payments and transfers) within a date range.
get_wallet_balance Retrieve the merchant's current PicPay wallet balance (available and blocked amounts in BRL).
generate_static_qrcode Generate a static PicPay Pay QR code for in-store / reusable use.
generate_dynamic_qrcode Generate a dynamic PicPay Pay QR code with a fixed amount and optional expiration.
create_payment_link Create a shareable PicPay payment link.

Install

npm install @codespar/mcp-picpay@alpha

Environment

PICPAY_TOKEN="..."          # Merchant integration token (x-picpay-token header)
PICPAY_SELLER_TOKEN="..."   # Seller token used to validate webhook callbacks
PICPAY_BASE_URL="..."       # Optional. Defaults to https://appws.picpay.com/ecommerce/public

Authentication

Every request sends:

Content-Type: application/json
x-picpay-token: <PICPAY_TOKEN>

PicPay webhook callbacks carry x-seller-token: <PICPAY_SELLER_TOKEN>. Use the validate_notification tool (or compare the header yourself) before trusting a payload, then fetch the authoritative status with get_payment_status.

Run

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-picpay

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-picpay

Status

0.1.0-alpha.1. Core checkout endpoints (/payments, /payments/{ref}/status, /payments/{ref}/cancellations) are verified against PicPay's public docs. Recurrency (plans + subscriptions) endpoints come from the documented path shape but field-level schemas (frequency enum values, subscription response) should be confirmed against the live API before production use.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Facts

Kind
MCP server
Repo
codespar/mcp-dev-latam
Group
Uncategorized
Stars
273
License
MIT
Language
TypeScript
Last push
2026-09-27
Forks
50
MCP Registry
io.github.codespar/mcp-picpay
Homepage
codespar.dev/servers
Topics
agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix

More on this shelf

  1. 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
  2. 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
  3. 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
  4. 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
  5. 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
  6. 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k