Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Description from the maker (original English)
MCP server for PicPay Business — BR digital wallet (60M+ users): checkout, Pix QR, subscriptions
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
Pick the AI app you use, then copy the settings.
Passed 2/2 checks · Runs on your computer
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a MCP Picpay key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
One time only; it works for every server that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
SettingsDeveloperEdit Config
{
"mcpServers": {
"picpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay"
],
"env": {
"PICPAY_TOKEN": "your-value",
"PICPAY_SELLER_TOKEN": "your-value",
"PICPAY_BASE_URL": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use MCP Picpay and tell me what you can do for me, then show me one thing✓ If Claude says it is using MCP Picpay or shows a MCP Picpay tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect MCP Picpay yet
MCP Picpay runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect MCP Picpay
B · Others in Online shops & payments that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a MCP Picpay key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
One time only; it works for every server that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add picpay --env PICPAY_TOKEN=your-value --env PICPAY_SELLER_TOKEN=your-value --env PICPAY_BASE_URL=your-value -- npx -y @codespar/mcp-picpayReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see MCP Picpay listed as connected
Use MCP Picpay and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using MCP Picpay or shows a MCP Picpay tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a MCP Picpay key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
One time only; it works for every server that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
In the MCP Picpay settings, PICPAY_TOKEN, PICPAY_SELLER_TOKEN, PICPAY_BASE_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use MCP Picpay and tell me what you can do for me, then show me one thing✓ If Cursor says it is using MCP Picpay or shows a MCP Picpay tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a MCP Picpay key (sign up on the maker’s site, may cost money) · Install Node.js on your computer first (one time)
One time only; it works for every server that needs Node.js
Open the maker’s site, sign up and create an API key for the next step. It may cost money.
How to get a key is in the maker’s README below
In the MCP Picpay settings, PICPAY_TOKEN, PICPAY_SELLER_TOKEN, PICPAY_BASE_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use MCP Picpay and tell me what you can do for me, then show me one thing✓ If VS Code says it is using MCP Picpay or shows a MCP Picpay tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add picpay --env PICPAY_TOKEN=your-value --env PICPAY_SELLER_TOKEN=your-value --env PICPAY_BASE_URL=your-value -- npx -y @codespar/mcp-picpayClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"picpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay"
],
"env": {
"PICPAY_TOKEN": "your-value",
"PICPAY_SELLER_TOKEN": "your-value",
"PICPAY_BASE_URL": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"picpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay"
],
"env": {
"PICPAY_TOKEN": "your-value",
"PICPAY_SELLER_TOKEN": "your-value",
"PICPAY_BASE_URL": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"picpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay"
],
"env": {
"PICPAY_TOKEN": "your-value",
"PICPAY_SELLER_TOKEN": "your-value",
"PICPAY_BASE_URL": "your-value"
}
}
}
}PICPAY_TOKEN secret required envPICPAY_SELLER_TOKEN secret required envPICPAY_BASE_URL envThese settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: @codespar/mcp-picpayBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026
The registry name was verified with the GitHub account codespar, which owns the repo
Code last changed last month
We have not read this repo from GitHub yet
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 2 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: PICPAY_TOKEN, PICPAY_SELLER_TOKEN
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed last month, and the latest version (0.2.0-alpha.3) reached the registry 5 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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.
| 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. |
npm install @codespar/mcp-picpay@alpha
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
Every request sends:
Content-Type: application/json
x-picpay-token:
PicPay webhook callbacks carry x-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.
# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-picpay
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-picpay
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.
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.
MIT