Peer Cash MCP

Prepare y gestione retiros en efectivo de USDC Base con custodia separada a través de Peer Cash usando nueve herramientas MCP.

Documentación

Peer Cash MCP server

Un servidor MCP para agentes que necesitan retirar USDC de Base a través de Peer Cash. Expone capacidades de pago en vivo, estimaciones de oráculo, preparación de transacciones sin firmar, finalización de recibos, consultas de órdenes, retiros y recargas.

El servidor nunca acepta claves privadas ni envía transacciones. Las herramientas de escritura devuelven transacciones de Base sin firmar para que la billetera anfitriona las revise, apruebe, firme y confirme.

El repositorio también es un paquete de Agent Plugins 1.0. plugin.json identifica el paquete, skills/peer-cash/SKILL.md proporciona el flujo de trabajo portátil y mcp.json inicia el servidor publicado sin incrustar credenciales.

Ejecución

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

El entorno predeterminado es producción y el RPC público de Base es suficiente para lecturas normales. Variables de entorno opcionales:

VariablePropósito
PEER_CASH_ENVIRONMENTproduction, preproduction o staging
PEER_CASH_RPC_URLRPC personalizado de Base para lecturas y finalización de recibos
PEER_CASH_API_KEYClave API de curador cuando el entorno seleccionado lo requiere
PEER_CASH_REFERRAL_CODECódigo de referencia de integración Peer de seis caracteres
PEER_CASH_REFERRERCódigo de atribución ERC-8021 solo para análisis

Flujo de herramientas

  1. Llame a peer_cash_capabilities antes de nombrar una plataforma de pago o moneda.
  2. Llame a peer_cash_estimate. Trátelo como aproximado: la tasa vinculante de Chainlink se resuelve cuando un comprador completa la orden.
  3. Llame a peer_cash_prepare con un monto de USDC de Base en unidades base de 6 decimales y una o más patas de pago.
  4. Muestre el plan de transacción devuelto y obtenga la aprobación explícita del usuario.
  5. Envíe cada transacción en orden a través de la billetera anfitriona y confírmela en Base.
  6. Llame a peer_cash_finalize con el hash de transacción createDeposit confirmado.
  7. Si accessPolicyRequired fue verdadero, llame a peer_cash_prepare_access_policy y envíe esa transacción con la billetera del depositante.
  8. Persista el depositId devuelto para el seguimiento y la recuperación de órdenes.

Los resultados desconocidos de transacciones deben inspeccionarse antes de cualquier reenvío. Los errores de Peer Cash incluyen un código, capacidad de reintento, remediación y evidencia de recuperación para este propósito.

Desarrollo

bun install
bun run ci

Requiere Node.js 22 o superior.

Valide el paquete portátil por separado del conjunto de pruebas del servidor:

npx skills-ref validate skills/peer-cash