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.):

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: clawpay-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

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.

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• grip_create_paymentA
• grip_list_paymentsA
• grip_settle_paymentA
• grip_walletA