{"name":"io.github.codespar/mcp-picpay","slug":"codespar-mcp-picpay","title":null,"description":"MCP server for PicPay Business — BR digital wallet (60M+ users): checkout, Pix QR, subscriptions","url":"https://mcp.market/server/codespar-mcp-picpay","rating":null,"grade":"B","score":82,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":45,"stars":271,"forks":50,"downloads_week":18,"last_push_at":"2026-08-29T02:02:48.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/codespar/mcp-dev-latam","website":null,"version":"0.2.0-alpha.3","remotes":[],"packages":[{"registryType":"npm","identifier":"@codespar/mcp-picpay","version":"0.2.0-alpha.3","transport":{"type":"stdio"},"environmentVariables":[{"description":"PicPay merchant integration token (sent as x-picpay-token header)","isRequired":true,"format":"string","isSecret":true,"name":"PICPAY_TOKEN"},{"description":"PicPay seller token used to validate webhook callbacks (x-seller-token header)","isRequired":true,"format":"string","isSecret":true,"name":"PICPAY_SELLER_TOKEN"},{"description":"PicPay ecommerce API base URL. Defaults to https://appws.picpay.com/ecommerce/public.","format":"string","name":"PICPAY_BASE_URL"}]}],"tools":[{"name":"cancel_payment","description":"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).","write_action":true,"price_micros":0,"input_schema":null},{"name":"cancel_subscription","description":"Cancel an active subscription. Future recurring charges are stopped; past charges are not refunded automatically.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_b2p_transfer","description":"Create a Business-to-Person (B2P) transfer: push funds from the merchant wallet to a PicPay user identified by CPF/CNPJ. Useful for payouts, cashbacks, rewards and marketplace splits. Amount in BRL decimal.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_batch_payment","description":"Submit a batch of B2P transfers in a single request. Each item is an independent transfer to a PicPay user; PicPay processes them asynchronously and notifies per-item via callback.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_payment","description":"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).","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_payment_link","description":"Create a shareable PicPay payment link. Returns a short URL the merchant can send via WhatsApp / email. The buyer opens the link and completes payment inside PicPay.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_plan","description":"Create a subscription plan (Recurrency API). Plans define the recurring amount, frequency, and trial.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_subscription","description":"Enroll a buyer in a subscription plan. Returns the subscription record and the buyer-facing authorization URL.","write_action":true,"price_micros":0,"input_schema":null},{"name":"delete_plan","description":"Delete a subscription plan. Fails if the plan has active subscriptions.","write_action":true,"price_micros":0,"input_schema":null},{"name":"generate_dynamic_qrcode","description":"Generate a dynamic PicPay Pay QR code with a fixed amount and optional expiration. Each QR is single-purpose. Returns qrcode content + base64 image and a paymentUrl.","write_action":false,"price_micros":0,"input_schema":null},{"name":"generate_static_qrcode","description":"Generate a static PicPay Pay QR code for in-store / reusable use. The buyer opens PicPay, scans the QR and types in the amount. Returns the QR content and a base64 image.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_b2p_transfer","description":"Get the status of a B2P transfer by referenceId. Typical statuses: created, processing, completed, failed.","write_action":true,"price_micros":0,"input_schema":null},{"name":"get_payment_status","description":"Get the status of a payment by referenceId. Typical statuses: created, expired, analysis, paid, completed, refunded, chargeback.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_subscription","description":"Retrieve a subscription by id.","write_action":false,"price_micros":0,"input_schema":null},{"name":"get_wallet_balance","description":"Retrieve the merchant's current PicPay wallet balance (available and blocked amounts in BRL). Useful before issuing refunds or B2P transfers.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_plans","description":"List all subscription plans registered for this merchant.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_transactions","description":"List merchant transactions (payments and transfers) within a date range. Supports pagination and optional status filter.","write_action":false,"price_micros":0,"input_schema":null},{"name":"refund_payment","description":"Refund a paid PicPay order, optionally partially. Unlike cancel_payment, this is the explicit refund endpoint and accepts a custom amount for partial refunds. The merchant wallet must have enough balance to cover the refund.","write_action":true,"price_micros":0,"input_schema":null},{"name":"update_plan","description":"Update an existing subscription plan.","write_action":true,"price_micros":0,"input_schema":null},{"name":"validate_notification","description":"Verify that an incoming webhook callback came from PicPay by comparing the x-seller-token header against PICPAY_SELLER_TOKEN. Use this in your callback handler before trusting the payload, then call get_payment_status to fetch the authoritative status.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":82,"grade":"B","scanned_at":"2026-09-26T21:19:02.100Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-26T21:19:02.115Z","components":{"code":{"score":25,"max":25,"notes":["5 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 29 days ago"]},"identity":{"score":7,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@codespar/mcp-picpay","version":"0.2.0-alpha.3","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":1,"publishedAt":"2026-06-22T18:45:36.498Z","weeklyDownloads":18}],"repo":{"found":true,"owner":"codespar","repo":"mcp-dev-latam","archived":false,"pushedAt":"2026-08-29T02:02:48Z","stars":271,"forks":50,"openIssues":10,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/269058982?v=4","ownerCreatedAt":"2026-03-18T00:40:56Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/269058982?v=4&s=128","source":"github"},"presence":{"stars":271,"forks":50,"downloadsWeek":18,"license":"MIT","lastPushAt":"2026-08-29T02:02:48.000Z","score":45}}}},"grade_history":[],"reviews":[]}