{"_id":"@codespar/mcp-picpay","_rev":"5-894be27e45904c04e83ccf2135e40615","name":"@codespar/mcp-picpay","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-picpay","version":"0.1.0-alpha.1","keywords":["mcp","picpay","picpay-business","payments","wallet","pix","qr-code","checkout","subscriptions","brazil","brasil"],"license":"MIT","_id":"@codespar/mcp-picpay@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-picpay":"dist/index.js"},"dist":{"shasum":"01e475f1d2431a98d5236271015fe2eb0fe21c40","tarball":"https://registry.npmjs.org/@codespar/mcp-picpay/-/mcp-picpay-0.1.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-uXjlDit73iAstu5cm0jPeXOcreH5lgkbvYXCbWI/bH4JKHsD3Zw60Hgofb11X9PTzkUfJIoL2HLwjgD4/7OQIg==","signatures":[{"sig":"MEYCIQDczl4KIY7tSP1pxQAseDUpbTIIsnx2sr5xSFYeFsA8/gIhAPzvZm+j5GPm2QQeRVImaw1O70+ynG1Os+j9U1+K28YL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40021},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e1164fd411e8952e8b9f8c723795dc85f86f15d2","mcpName":"io.github.codespar/mcp-picpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for PicPay Business — Brazilian digital wallet with 60M+ users. Merchant checkout API, Pix QR, refunds, cancellations, and recurring subscriptions.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-picpay_0.1.0-alpha.1_1776993349921_0.8985622201998238","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-picpay","version":"0.2.0-alpha.1","keywords":["mcp","picpay","picpay-business","payments","wallet","pix","qr-code","checkout","subscriptions","brazil","brasil"],"license":"MIT","_id":"@codespar/mcp-picpay@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-picpay":"dist/index.js"},"dist":{"shasum":"cc8074836aa03839204b09328d4c7d5e53328865","tarball":"https://registry.npmjs.org/@codespar/mcp-picpay/-/mcp-picpay-0.2.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-r2/3ne27bUda7Zdq+M3Km/wPD2gvghhs04HMD4uZbE7+w9NEKcAJ6WamhBEdGX9OdknBsKoGcSuQqZ0ht5T7QQ==","signatures":[{"sig":"MEUCIG3PAuP7+NZBxwTmY7VhAXsS8+tf/vhkMyInuT9DWkJTAiEA637dYwZIOzO8agXXHETlJP+XTgTKCw5WRTQ5igUFz1c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61930},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"206367773b96786003af53c16c38c7c3d6f823bd","mcpName":"io.github.codespar/mcp-picpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for PicPay Business — Brazilian digital wallet with 60M+ users. Merchant checkout API, Pix QR, refunds, cancellations, and recurring subscriptions.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-picpay_0.2.0-alpha.1_1777069519151_0.35815589671148595","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-picpay","version":"0.2.0-alpha.2","keywords":["mcp","picpay","picpay-business","payments","wallet","pix","qr-code","checkout","subscriptions","brazil","brasil"],"license":"MIT","_id":"@codespar/mcp-picpay@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-picpay":"dist/index.js"},"dist":{"shasum":"a9428a93317af339f8696dc1d6e80168495fa48f","tarball":"https://registry.npmjs.org/@codespar/mcp-picpay/-/mcp-picpay-0.2.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-fZ+2UoEMJpN412Kixvm9q5dtYdMVF0YI5ycswRJTsrfo013JTKAsb3Tnw2scUUif9qII45sWA9WgV5r5k/uMdw==","signatures":[{"sig":"MEYCIQCCDUY8KRTrc60Ui2KEJu5Sdm72TuW++/iRitegjQjvEgIhAOOOeioWSGEpPHEmupEVlv0nW4ZcoXtiQT4pJIXDo2Mi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62789},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-picpay","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for PicPay Business — Brazilian digital wallet with 60M+ users. Merchant checkout API, Pix QR, refunds, cancellations, and recurring subscriptions.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-picpay_0.2.0-alpha.2_1777123245873_0.8068160259820809","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-picpay","version":"0.2.0-alpha.3","description":"MCP server for PicPay Business — Brazilian digital wallet with 60M+ users. Merchant checkout API, Pix QR, refunds, cancellations, and recurring subscriptions.","type":"module","main":"./dist/index.js","bin":{"mcp-picpay":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","picpay","picpay-business","payments","wallet","pix","qr-code","checkout","subscriptions","brazil","brasil"],"mcpName":"io.github.codespar/mcp-picpay","_id":"@codespar/mcp-picpay@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-SbvFnmQUyUgK0mNKFA+40lJV11DV+UBBX9wGwuxaatNu8hZcgitE4vxoRKqdEtG+3Nr0nwUScE1B9WUI5LAOKQ==","shasum":"0ea5205b28b1fe8ab044a12dc423309a323b1cb1","tarball":"https://registry.npmjs.org/@codespar/mcp-picpay/-/mcp-picpay-0.2.0-alpha.3.tgz","fileCount":6,"unpackedSize":64224,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHtXE1UBesZffubuhEA/FYN3g5EQlqTQ+vAREBzB+QKTAiB9aI0G+MEb2TuqyUV66Ws7ZnbkhxZiZdZbMUVBs8p5Cg=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-picpay_0.2.0-alpha.3_1782153936350_0.12989106724423682"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:15:49.719Z","modified":"2026-06-22T18:45:36.673Z","0.1.0-alpha.1":"2026-04-24T01:15:50.112Z","0.2.0-alpha.1":"2026-04-24T22:25:19.313Z","0.2.0-alpha.2":"2026-04-25T13:20:46.011Z","0.2.0-alpha.3":"2026-06-22T18:45:36.498Z"},"license":"MIT","keywords":["mcp","picpay","picpay-business","payments","wallet","pix","qr-code","checkout","subscriptions","brazil","brasil"],"description":"MCP server for PicPay Business — Brazilian digital wallet with 60M+ users. Merchant checkout API, Pix QR, refunds, cancellations, and recurring subscriptions.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-picpay\n\nMCP server for [PicPay Business](https://developers-business.picpay.com) — Brazilian digital wallet with 60M+ users.\n\nPicPay'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.\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `create_payment` | Create a PicPay checkout payment. |\n| `get_payment_status` | Get the status of a payment by referenceId. |\n| `cancel_payment` | Cancel a PicPay order. |\n| `create_plan` | Create a subscription plan (Recurrency API). |\n| `list_plans` | List all subscription plans registered for this merchant. |\n| `update_plan` | Update an existing subscription plan. |\n| `delete_plan` | Delete a subscription plan. |\n| `create_subscription` | Enroll a buyer in a subscription plan. |\n| `get_subscription` | Retrieve a subscription by id. |\n| `cancel_subscription` | Cancel an active subscription. |\n| `validate_notification` | Verify that an incoming webhook callback came from PicPay by comparing the x-seller-token header against PI... |\n| `refund_payment` | Refund a paid PicPay order, optionally partially. |\n| `create_b2p_transfer` | Create a Business-to-Person (B2P) transfer: push funds from the merchant wallet to a PicPay user identified... |\n| `get_b2p_transfer` | Get the status of a B2P transfer by referenceId. |\n| `create_batch_payment` | Submit a batch of B2P transfers in a single request. |\n| `list_transactions` | List merchant transactions (payments and transfers) within a date range. |\n| `get_wallet_balance` | Retrieve the merchant's current PicPay wallet balance (available and blocked amounts in BRL). |\n| `generate_static_qrcode` | Generate a static PicPay Pay QR code for in-store / reusable use. |\n| `generate_dynamic_qrcode` | Generate a dynamic PicPay Pay QR code with a fixed amount and optional expiration. |\n| `create_payment_link` | Create a shareable PicPay payment link. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-picpay@alpha\n```\n\n## Environment\n\n```bash\nPICPAY_TOKEN=\"...\"          # Merchant integration token (x-picpay-token header)\nPICPAY_SELLER_TOKEN=\"...\"   # Seller token used to validate webhook callbacks\nPICPAY_BASE_URL=\"...\"       # Optional. Defaults to https://appws.picpay.com/ecommerce/public\n```\n\n## Authentication\n\nEvery request sends:\n\n```\nContent-Type: application/json\nx-picpay-token: <PICPAY_TOKEN>\n```\n\nPicPay 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`.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-picpay\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-picpay\n```\n\n## Status\n\n`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.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}