Skip to main content
SA

Safrapay

v0.2.0-alpha.2API Keyalpha

Credenciadora do Banco Safra — segmento premium/enterprise de private banking. Opera na plataforma de pagamentos da Aditum. Autorizar/capturar/cancelar, Pix, boleto, tokenização, split, extratos digitais. Alpha no npm — recipe de auth BCRYPT e casing do body pendentes de validação em sandbox.

22 ferramentas4 env vars🇧🇷 Brasilalpha — validação pendente

O que seu agente faz

O Safrapay dá ao seu agente 22 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.

  • authorize_paymentAuthorize a credit-card payment on Safrapay. Set preauth=true to authorize only (use capture_payment later); false to authorize+capture atomically.
  • capture_paymentCapture a previously authorized (pre-auth) payment.
  • cancel_paymentCancel (void) an authorized-but-uncaptured payment. Also used for full refund of a captured payment in Safrapay.
Exemplo de chamada
// 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("authorize_payment", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-safrapay@alpha

Quickstart

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "safrapay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-safrapay@alpha"
      ],
      "env": {
        "SAFRAPAY_CLIENT_ID": "<your_safrapay_client_id>",
        "SAFRAPAY_CLIENT_SECRET": "<your_safrapay_client_secret>",
        "SAFRAPAY_MERCHANT_ID": "<your_safrapay_merchant_id>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 22 ferramentas abaixo — teste authorize_payment primeiro.

Variáveis de ambiente · 4

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

SAFRAPAY_CLIENT_ID
obrigatório

Safrapay merchant CNPJ (sent as merchantCredential header on auth)

SAFRAPAY_CLIENT_SECRET
obrigatóriosecret

Safrapay MerchantToken used to compute the BCRYPT Authorization header on auth

SAFRAPAY_MERCHANT_ID
obrigatório

Safrapay merchant id (used in request bodies where applicable)

SAFRAPAY_ENV
opcional

Environment: 'sandbox' or 'production'. Defaults to sandbox.

Ferramentas disponíveis · 22

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

WRITEauthorize_payment
Authorize a credit-card payment on Safrapay. Set preauth=true to authorize only (use capture_payment later); false to authorize+capture atomically.
WRITEcapture_payment
Capture a previously authorized (pre-auth) payment.
DELETEcancel_payment
Cancel (void) an authorized-but-uncaptured payment. Also used for full refund of a captured payment in Safrapay.
DELETErefund_payment
Refund a captured payment. Pass amount for a partial refund; omit for full. Safrapay routes both through /v2/charge/cancelation with an amount field.
WRITEcreate_pix
Create a Pix charge. Returns qr_code (EMV copy-paste payload), qr_code_image, and chargeId.
WRITEcreate_boleto
Create a boleto charge. Returns boleto PDF URL, barcode, digitable line, and expiration date.
WRITEget_payment
Retrieve a charge by Safrapay chargeId. Works for credit, Pix, and boleto.
WRITEtokenize_card
Tokenize a card for PCI-safe reuse. Set temporary=true for a single-use token (POST /v2/temporary/card); false for a persistent card-on-file (POST /v2/card).

Frameworks compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Qualquer cliente MCPProtocolo

Perguntas frequentes

Rode `npx -y @codespar/mcp-safrapay` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Safrapay — MCP server · 22 tools | CodeSpar