RebornDocs

MCP

O agente consulta a conta, cria cobrança e explica o negócio com a mesma secret key.

O endpoint é POST /mcp, transporte Streamable HTTP, no mesmo host da API. Sandbox: https://sandbox-api.rebornpay.io/mcp. Dev e produção trocam o host para dev-api.rebornpay.io e api.rebornpay.io.

A secret key vai no header X-Api-Key, a mesma de Integrações no dashboard. Use a key do mesmo ambiente da URL. Não cole a chave neste guia e não commite o arquivo com ela. Outro cliente entra do mesmo jeito se falar Streamable HTTP e enviar esse header.

Como usar no Cursor

Arquivo: .cursor/mcp.json

  1. 1No projeto, crie .cursor/mcp.json. Para valer em qualquer pasta, use ~/.cursor/mcp.json.
  2. 2Cole o JSON e troque rk_sua_secret_key. Para não gravar a chave, use "${env:REBORN_API_KEY}".
  3. 3Abra Customize e confira o servidor reborn. Se não conectar, Output → MCP Logs mostra o erro.

mcp.json

{
  "mcpServers": {
    "reborn": {
      "url": "https://sandbox-api.rebornpay.io/mcp",
      "headers": {
        "X-Api-Key": "rk_sua_secret_key"
      }
    }
  }
}

Valor de cobrança, link, estorno e saque entra em reais. 10, 10,00, 10.00 e 10 reais são dez reais. As respostas de gestão voltam em reais, com um resumo em português.

idempotencyKey é opcional na cobrança PIX, no estorno e no saque. Sem ela, o MCP gera uma e devolve na resposta. Reenviar a mesma chave repete a operação sem criar outra.

Conta e operação do dia:

  • Perfil do seller. Key de company lista os sub-sellers.
  • Saldo por moeda e posição de caixa: sacável, cartão, reserva e taxa do saque.
  • Lista e detalhe de transações, links, compradores e saques.
  • Chaves PIX, assinaturas e entregas de webhook.

Saúde do negócio, no mesmo cálculo do painel:

  • Nota de 0 a 100 nos últimos 30 dias, com aprovação, chargeback e estorno.
  • Vendas do período, volume, ticket e mix de meios.
  • Base de compradores, LTV e extrato.
  • Taxas do plano, explicação de uma venda, disputas e MED.

Pedidos que exercitam isso:

  • como está o negócio nos últimos 7 dias?
  • por que o líquido desta venda ficou nesse valor?
  • quanto dá para sacar agora?

  • Cria comprador.
  • Cria, altera, ativa e desativa link de pagamento.
  • Cria cobrança PIX. Cartão e 3DS ficam de fora.
  • Estorna uma transação paga. Sem valor, estorna o total.

Peça "cria um link de 10 reais" ou "cria um PIX de R$ 10". O contrato HTTP dessas operações continua na API Reference.

O saque sai em dois passos. prepare_pix_payout devolve valor, destino, taxa e um token que vale 15 minutos. O dinheiro só sai em confirm_pix_payout, depois que a pessoa confirmar o resumo.

Com API key de company, o agente lê o saldo da rede, a comissão do período e a nota de saúde de até 50 sub-sellers.