Skip to main content
Glama

Grip MCP

Dale a Claude (o a cualquier agente compatible con MCP) una billetera USDC sin custodia en Base, con aprobación humana en cada pago.

Qué es esto

@grip-foundation/grip-mcp es un servidor del Protocolo de Contexto de Modelo (MCP) que expone cuatro herramientas a cualquier cliente compatible con MCP (Claude Desktop, Claude Code, Continue, etc.):

Herramienta

Qué hace

Quién aprueba

grip_wallet

Devuelve la dirección de la cuenta inteligente del agente + saldo de USDC en Base.

—

grip_create_payment

Prepara un pago (fuera de la cadena). Devuelve un token de aprobación.

—

grip_settle_payment

Liquida o rechaza un pago preparado. Al aprobar, ejecuta una transferencia real de USDC en la red principal de Base.

Humano, en el chat

grip_list_payments

Enumera los pagos recientes de la sesión.

—

El agente nunca mueve dinero sin ti. El flujo es: el agente prepara → tú confirmas en el chat → el agente liquida. No existe la autoaprobación programática.

Related MCP server: @arispay/payagent-mcp

Instalación

Opción 1 — vía npx (después de la primera publicación)

En ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "grip": {
      "command": "npx",
      "args": ["-y", "@grip-foundation/grip-mcp"]
    }
  }
}

Opción 2 — clonación local

git clone https://github.com/grip-foundation/grip-mcp.git
cd grip-mcp
pnpm install
pnpm run build

Luego apunta Claude Desktop al archivo compilado:

{
  "mcpServers": {
    "grip": {
      "command": "node",
      "args": ["/absolute/path/to/grip-mcp/dist/server/index.js"]
    }
  }
}

Reinicia Claude Desktop después de editar la configuración.

Primera ejecución

La primera vez que se inicia el servidor, genera una clave privada EOA nueva y la almacena en ~/.grip-mcp/agent-key (modo 0600). Esta clave controla la cuenta inteligente.

En Claude, pregunta:

Muéstrame mi billetera Grip

Claude llamará a grip_wallet y responderá con la dirección de tu cuenta inteligente, el saldo y los límites. Envía USDC en Base a esa dirección para fondearla.

Realizar un pago

Una vez fondeada, pídele a Claude algo como:

Envía 5 USDC a 0xba14744FfD57FA7d03b20D4c8BeDAaC301E865d1

Claude hará lo siguiente:

  1. Llamará a grip_create_payment para preparar el pago fuera de la cadena.

  2. Te mostrará los detalles (cantidad, destinatario, nota) y pedirá confirmación.

  3. Esperará tu respuesta.

  4. Si dices "aprobar" → llamará a grip_settle_payment(token, "approve") → se ejecuta en Base.

  5. Si dices "no" → llamará a grip_settle_payment(token, "reject") → no se realiza ninguna acción en la cadena.

El hash de la transacción y el enlace a Basescan se devuelven al liquidar.

Configuración

Variable de entorno

Predeterminado

Qué hace

GRIP_MCP_PRIVATE_KEY

(autogenerado)

Sobrescribe la clave privada del firmante del agente. Útil para restaurar una billetera en diferentes máquinas.

GRIP_MCP_KEY_PATH

~/.grip-mcp/agent-key

Dónde se almacena la clave autogenerada.

GRIP_MCP_PER_TX_CAP

100

USDC máximo por pago individual.

GRIP_MCP_DAILY_CAP

500

USDC máximo en todos los pagos por día UTC.

Modelo de seguridad

  • Sin custodia. La Fundación Grip no guarda tus claves, tu USDC ni ningún registro de tus pagos. Todo se ejecuta en tu máquina.

  • Paymaster gestionado, sin registro. El gas se paga en USDC a través del paymaster de Pimlico enrutado mediante el proxy alojado de Grip. No necesitas una cuenta de Pimlico.

  • El factor humano es impuesto por el protocolo, no por el modelo. grip_create_payment solo prepara. grip_settle_payment es una llamada de herramienta separada. La mayoría de los clientes MCP (incluido Claude Desktop) solicitan confirmación humana antes de ejecutar llamadas de herramientas; esa es una segunda capa de control.

  • Los límites se aplican en el lado del servidor. Incluso si el modelo intenta un pago que supera tu límite por transacción o diario, el servidor se negará a prepararlo.

Arquitectura

Claude Desktop
     │ MCP (stdio)
     ▼
grip-mcp (this server)
     │ @grip-labs/sdk
     ▼
Grip-managed paymaster proxy → Pimlico bundler → Base mainnet
                                                       ▲
                                                  Coinbase Smart Wallet
                                                  (your smart account)

La cuenta inteligente es una Coinbase Smart Wallet (ERC-4337) en Base. El primer pago desde una billetera nueva ejecuta un UserOp de arranque único que despliega la cuenta y aprueba el paymaster para el reembolso de USDC; los UserOps posteriores se pagan con USDC.

Problemas conocidos

El primer pago puede requerir un reintento. En @grip-labs/sdk@0.4, el UserOp de arranque (despliegue + aprobación de paymaster) y el UserOp de transferencia real se envían como dos operaciones separadas. Existe una pequeña ventana de carrera donde getFactoryArgs() interno de viem lee un getCode obsoleto del RPC público después de que el arranque se haya liquidado en el bundler de Pimlico; viem entonces incluye initCode en el segundo UserOp y el bundler lo rechaza con AA10 sender already constructed.

Si tu primer pago falla con ese error, simplemente pídele al agente que lo intente de nuevo. El reintento tiene éxito porque el estado en la cadena se ha propagado para entonces. Los pagos posteriores desde la misma billetera son limpios: el arranque se ejecuta como máximo una vez por billetera.

Se está lanzando una corrección en @grip-labs/sdk@0.5 que consolida el arranque + la primera transferencia en un único UserOp patrocinado usando executeBatch, eliminando la carrera por construcción y ahorrando aproximadamente un 30% de gas en el primer pago. grip-mcp lo incluirá en la versión 0.1.1.

Licencia

MIT

Creado por

Grip Foundation · identidad abierta + rieles de pago para agentes de IA.

Available Tools

4 tools
grip_create_paymentCreate a pending payment (requires human approval)A

Stages a payment from the agent's Grip wallet to a recipient. DOES NOT execute on-chain. Returns an approval_token. You MUST then show the payment details (amount, recipient, memo) to the human in plain language and ASK FOR EXPLICIT CONFIRMATION before calling grip_settle_payment. Never auto-approve. The human must say 'approve' (or equivalent) before settling. If they say 'no', call grip_settle_payment with decision='reject'.

Inputs: recipient (required), amount_usdc (required), memo.

grip_list_paymentsList recent payments from this sessionA
Read-onlyIdempotent

Returns recent payments (pending, settled, rejected, failed) staged or executed in this MCP session. Read-only. Useful when the human asks 'what have I paid today' or 'what's pending'.

Inputs: limit.

grip_settle_paymentSettle (or reject) a pending paymentA
DestructiveIdempotent

Executes the on-chain transfer for a previously-staged payment, or marks it as rejected. ONLY call this after the human has explicitly confirmed (or declined) the payment in plain language. If the human has not confirmed, do not call this tool. On approve, this performs a real USDC transfer on Base mainnet via the Pimlico paymaster — it is irreversible.

Inputs: approval_token (required), decision (required).

grip_walletGet the agent's Grip wallet infoA
Read-onlyIdempotent

Returns this agent's Grip Pay wallet address (Base mainnet smart account) and current USDC balance. Use this when the human asks about the wallet, where to fund it, how much USDC the agent has, or before suggesting any payment.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: creating staged payments, listing payments, settling/rejecting, and checking wallet info. No overlap or ambiguity.

    Naming Consistency4/5

    All tools start with 'grip_' and most follow a verb_noun pattern (create_payment, list_payments, settle_payment). The exception is 'grip_wallet', which is a noun phrase, but the inconsistency is minor given the small set.

    Tool Count5/5

    Four tools is well-scoped for a payment/wallet MCP server. It covers staging, settling, listing, and wallet info without being too few or excessive.

    Completeness4/5

    The tool surface covers the core payment workflow: create, settle/reject, list, and wallet info. A potential minor gap is lack of explicit cancellation for staged payments, but the reject option in settle effectively handles that.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to manage USDC wallets on Solana, allowing them to send payments, create invoices, and access paid APIs within human-defined spending limits. It uses threshold signatures to provide agents with financial autonomy while ensuring secure oversight and transaction approval.
      36
      70 npm
      4
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides AI agents with a wallet and access to 900+ pay-per-call intelligence APIs across 74 verticals, with automatic USDC payments on Base and built-in spend guardrails.
      5
      110 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to make non-custodial USDC payments on Base through an MCP endpoint, with server-enforced per-payment and daily caps, human approval bands, and recipient allowlists.
      7
      39 npm
      MIT

    Appeared in Searches