Grip MCP
OfficialGrip 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 |
| Devuelve la dirección de la cuenta inteligente del agente + saldo de USDC en Base. | — |
| Prepara un pago (fuera de la cadena). Devuelve un token de aprobación. | — |
| Liquida o rechaza un pago preparado. Al aprobar, ejecuta una transferencia real de USDC en la red principal de Base. | Humano, en el chat |
| 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 buildLuego 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:
Llamará a
grip_create_paymentpara preparar el pago fuera de la cadena.Te mostrará los detalles (cantidad, destinatario, nota) y pedirá confirmación.
Esperará tu respuesta.
Si dices "aprobar" → llamará a
grip_settle_payment(token, "approve")→ se ejecuta en Base.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 |
| (autogenerado) | Sobrescribe la clave privada del firmante del agente. Útil para restaurar una billetera en diferentes máquinas. |
|
| Dónde se almacena la clave autogenerada. |
|
| USDC máximo por pago individual. |
|
| 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_paymentsolo prepara.grip_settle_paymentes 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 toolsgrip_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 sessionARead-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 paymentADestructiveIdempotent
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 infoARead-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
Scored across 4 tools
Each tool has a clear, distinct purpose: creating staged payments, listing payments, settling/rejecting, and checking wallet info. No overlap or ambiguity.
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.
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.
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
Related MCP Connectors
Give AI agents a wallet with a spending limit. Non-custodial USDC on Base, server-enforced limits.
Self-custodial USDC wallet on Base for AI agents: on-chain caps, Face ID, one-tap pause.
Shared USDC wallets for agents and teams, with optional write access and human-signed payments.
Monetization and execution gateway for autonomous AI agents on Base Mainnet
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.3670 npm4Apache 2.0

@arispay/payagent-mcpofficial
AlicenseAqualityBmaintenanceEnables AI agents to call paid APIs and settle HTTP 402 payment challenges with USDC on Base, without private keys ever being involved.7265 npmMIT- AlicenseAqualityDmaintenanceProvides 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.5110 npmMIT
- AlicenseAqualityBmaintenanceEnables 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.739 npmMIT