Peer Cash MCP

Prepare e gerencie saques de USDC na Base com custódia separada por meio do Peer Cash usando nove ferramentas MCP.

Documentação

Peer Cash MCP server

Um servidor MCP para agentes que precisam sacar USDC da Base por meio do Peer Cash. Ele expõe capacidades de pagamento em tempo real, estimativas de oráculo, preparação de transações não assinadas, finalização de recibos, leituras de pedidos, saques e recargas.

O servidor nunca aceita chaves privadas nem envia transações. As ferramentas de escrita retornam transações não assinadas da Base para a carteira do host revisar, aprovar, assinar e confirmar.

O repositório também é um pacote Agent Plugins 1.0. plugin.json identifica o pacote, skills/peer-cash/SKILL.md fornece o fluxo de trabalho portátil e mcp.json inicia o servidor publicado sem incorporar credenciais.

Executar

{
  "mcpServers": {
    "peer-cash": {
      "command": "npx",
      "args": ["-y", "peer-cash-mcp"]
    }
  }
}

O ambiente padrão é produção e o RPC público da Base é suficiente para leituras normais. Variáveis de ambiente opcionais:

VariávelFinalidade
PEER_CASH_ENVIRONMENTproduction, preproduction ou staging
PEER_CASH_RPC_URLRPC personalizado da Base para leituras e finalização de recibos
PEER_CASH_API_KEYChave de API do curador quando o ambiente selecionado exigir uma
PEER_CASH_REFERRAL_CODECódigo de indicação de integração Peer de seis caracteres
PEER_CASH_REFERRERCódigo de atribuição ERC-8021 somente para análise

Fluxo de ferramentas

  1. Chame peer_cash_capabilities antes de nomear uma plataforma de pagamento ou moeda.
  2. Chame peer_cash_estimate. Trate-o como aproximado: a taxa Chainlink vinculante é resolvida quando um comprador preenche o pedido.
  3. Chame peer_cash_prepare com um valor de USDC da Base em unidades base de 6 decimais e uma ou mais pernas de pagamento.
  4. Mostre o plano de transação retornado e obtenha aprovação explícita do usuário.
  5. Envie cada transação em ordem pela carteira do host e confirme-a na Base.
  6. Chame peer_cash_finalize com o hash de transação createDeposit confirmado.
  7. Se accessPolicyRequired for verdadeiro, chame peer_cash_prepare_access_policy e envie essa transação com a carteira do depositante.
  8. Persista o depositId retornado para rastreamento e recuperação de pedidos.

Resultados desconhecidos de transações devem ser inspecionados antes de qualquer reenvio. Os erros do Peer Cash incluem um código, capacidade de nova tentativa, remediação e evidências de recuperação para esse fim.

Desenvolvimento

bun install
bun run ci

Requer Node.js 22 ou mais recente.

Valide o pacote portátil separadamente do conjunto de testes do servidor:

npx skills-ref validate skills/peer-cash