Carteira digital brasileira com mais de 60M de usuários. API de checkout para merchants pra pagamentos, planos de recorrência e assinaturas. Release alpha no npm — pagamentos core verificados, formatos do payload de recorrência pendentes de validação em sandbox.
O PicPay dá ao seu agente 20 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.
create_payment — 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).get_payment_status — Get the status of a payment by referenceId. Typical statuses: created, expired, analysis, paid, completed, refunded, chargeback.cancel_payment — 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).// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });$ npm install @codespar/mcp-picpay@alphaAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"mcpServers": {
"picpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-picpay@alpha"
],
"env": {
"PICPAY_TOKEN": "<your_picpay_token>",
"PICPAY_SELLER_TOKEN": "<your_picpay_seller_token>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 20 ferramentas abaixo — teste create_payment primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
PICPAY_TOKENPicPay merchant integration token (sent as x-picpay-token header)
PICPAY_SELLER_TOKENPicPay seller token used to validate webhook callbacks (x-seller-token header)
PICPAY_BASE_URLPicPay ecommerce API base URL. Defaults to https://appws.picpay.com/ecommerce/public.
Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.
create_paymentget_payment_statuscancel_paymentcreate_planlist_plansupdate_plandelete_plancreate_subscriptionMCP é um protocolo — qualquer framework que o fale pode montar este server.