trippy-mcp

Permite que tu agente de codificación opere en Injective. trippy-mcp es un servidor stdio MCP que se conecta a Claude Code, Codex, Cursor (cualquier cliente MCP) y le proporciona herramientas para:

• lanzar tokens en SHROOM Pad (curva de vinculación → se gradúa a un pool Choice CLMM)

• operar tokens de curva de vinculación (comprar/vender/cotizar, cotizaciones exactas en cadena)

• intercambiar cualquier token de Injective a través del enrutador de agregación Choice (enrutamiento inteligente AMM + CLMM + libro de órdenes)

• llevar una identidad de agente: las operaciones de tu agente obtienen una insignia AGENT en Trippy Terminal, opcionalmente vinculada a tu perfil

No custodia por construcción. init genera una clave nueva en tu máquina; ningún servidor la ve nunca. La cartera del agente es una cartera de uso único con presupuesto que financias desde tu cartera principal — nunca tu clave principal.

Inicio rápido

npx trippy-mcp init      # generate the agent wallet, pick a name, register,
                         # and wire up every coding agent found on this machine
# then fund the printed address with a small INJ budget

Luego solo habla con tu agente: "¿qué está trending en shroom pad? cotiza una compra de 0.5 INJ en la primera" — o "lanza un token llamado ... con este logo".

init escribe la entrada MCP por ti. Para añadir más clientes después, o para conectar un repositorio:

trippy-mcp connect --client claude,codex,cursor,windsurf   # or --client all
trippy-mcp connect --scope project                         # writes ./.mcp.json
trippy-mcp connect --print                                 # just show the snippets

Las escrituras son fusionar y luego renombrar con una copia .trippy-bak guardada, por lo que nada más en ~/.claude.json (o tu TOML de Codex, comentarios y todo) se ve afectado. La frase de paso del almacén de claves solo se incrusta en archivos de ámbito de usuario, chmod 0600 — la configuración del proyecto se envía a git, por lo que se omite con una nota.

Related MCP server: cook4fun-mcp

Modelo de seguridad

La clave nunca sale de tu máquina, y cuatro capas independientes se interponen entre un modelo que se comporta mal (o con inyección de indicaciones) y tus fondos:

1. Cartera de uso único con presupuesto — la cartera solo contiene lo que le envías. Tu cartera principal nunca se toca.

2. Motor de políticas en el firmante (no en las herramientas, no en el modelo): límite en USD por transacción, presupuesto renovable de 24 horas, límite de deslizamiento y una lista blanca de contratos estricta (LaunchpadCore, sus activos de cotización, el agregador Choice, el contrato de reclamación de drops — nada más). Configurado en ~/.trippy-mcp/config.json; cambiarlo es una acción humana.

3. El barrido es unidireccional a casa — sweep no toma destino. Los fondos solo pueden ir a la dirección del propietario que fijaste en init. Los airdrops son la única excepción que envía valor a direcciones que no nombraste, por lo que tienen su propio límite (airdropCapUsd, separado del límite de operaciones), nunca se les permite omitir la valoración en USD, y requieren un id de plan previsualizado en lugar de criterios brutos.

4. Disciplina de datos no confiables — los nombres/descripciones de tokens son texto de internet controlado por atacantes; las herramientas los sanitizan y los encierran bajo untrusted_metadata para que tu agente los trate como datos, no como instrucciones.

Además: almacén de claves cifrado por defecto (scrypt + AES-256-GCM), registro de auditoría de solo añadido (~/.trippy-mcp/audit.log), modo dryRun y un interruptor de apagado tradingEnabled. export-key existe pero te grita.

Tools

buy/sell/quote/portfolio/sweep indican su alcance en sus descripciones, para que un modelo con el Injective MCP también conectado elija el servidor correcto (y la billetera correcta) — consulte abajo.

Los nombres de las herramientas son verbos simples. Claude Code los organiza en espacios de nombres por ti (mcp__trippy__buy); en entornos que muestran una lista plana, establece TRIPPY_MCP_TOOL_PREFIX=trippy en el entorno del servidor para registrar trippy_buy, trippy_sell y así sucesivamente.

Junto al Injective AI SDK

@injectivelabs/ainj incluye su propio servidor MCP, y ambos están diseñados para ejecutarse juntos — nada choca por nombre y la división es limpia:

Firman para diferentes billeteras. El Injective MCP's wallet_generate / wallet_import escribe en ~/.injective-agent/keys/; esas direcciones no pueden comerciar aquí. Cuando ese almacén de claves está presente, wallet_status y agent_info lo reportan bajo otherAgentWallets para que el modelo lo diga en voz alta en lugar de reportar un cero confuso.

Manténlo así. El emparejamiento previsto es un bucle de financiación — financia este agente desde tu propia billetera (el transfer_send del Injective MCP funciona bien), sweep las ganancias de vuelta — no una clave compartida. Ese servidor firma sin política de gasto y toma la contraseña del almacén de claves como argumento de herramienta, por lo que importar la clave de este agente en él anularía el límite por transacción, el presupuesto diario y el destino fijo de sweep de un solo golpe.

Hay una habilidad que enseña a un agente todo lo anterior:

npx skills add danvaneijck/trippy-mcp --skill injective-memecoin-trading

Identidad del agente

init registra el nombre de tu agente en el registro de Trippy (firmado por la clave del agente — prueba de control de clave, nada de custodia). A partir de entonces, sus operaciones muestran una insignia AGENT en Trippy Terminal. Para adjuntarlo a tu perfil ("operado por ti"), ejecuta trippy-mcp claim-code e ingresa el código en Terminal → Settings → Agents con tu billetera principal.

Dale al agente una imagen de perfil con --avatar (en init o cualquier register posterior): pasa una URL https, o un archivo local .png/.jpg/.webp/.gif — los archivos locales se suben a IPFS a través de la API de SHROOM. La imagen se muestra dondequiera que el Terminal muestre avatares de perfil para la dirección del agente. Volver a registrar sin --avatar mantiene la imagen actual. Una vez que un agente es reclamado, su nombre y avatar también se pueden editar desde Terminal → Settings → Agents sin necesidad de un viaje de ida y vuelta por CLI.

Identidad en cadena (ERC-8004)

El registro anterior es de Trippy. Injective también tiene uno a nivel de ecosistema, en cadena: ERC-8004 NFTs de identidad con un registro de reputación detrás, en 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 en mainnet. Acuñar uno hace que tu agente sea descubrible más allá de este terminal, y portátil a cada cadena en la que ese registro esté desplegado. Cuesta una transacción, una fracción de un centavo.

trippy-mcp identity register        mint the identity (one tx)
trippy-mcp identity show            read it back from the chain
trippy-mcp identity transfer --yes  hand it to your owner wallet
trippy-mcp identity link            sign the wallet link your wallet submits

register deja al agente siendo dueño de su propia identidad. Transferírtela a ti es lo que evita que una clave de agente comprometida se lleve la identidad consigo, y el orden importa:

1. identity transfer --yes envía el NFT a la dirección del propietario fijada en init. Esto borra el puntero del registro de vuelta al agente, por lo que sus operaciones dejan de ser atribuidas a la identidad hasta el paso 3.

2. identity link firma un mensaje autorizando a tu billetera a re-apuntarlo. El registro rechaza cualquier plazo superior a 300 segundos, por lo que esta firma está viva durante unos cuatro minutos por diseño, y volver a ejecutar el comando es gratuito.

3. En Terminal → Settings → Agents, presiona Complete on-chain link. Esa es una transacción real desde tu billetera, por lo que cuesta gas. Si el contador expira, ejecuta identity link nuevamente.

agent_info reporta la identidad y qué lado tiene la custodia, para que el agente pueda decírtelo por sí mismo, junto con su página en 8004scan.

CLI

trippy-mcp init          create wallet + identity, then connect detected clients
                         (interactive; --plaintext, --network testnet, --avatar <url|path>, --no-connect)
trippy-mcp serve         run the MCP server (this is what your agent client launches)
trippy-mcp connect       write the MCP entry into your coding agent's config
                         (--client claude|codex|cursor|windsurf|all, --scope user|project,
                          --name <server-name>, --no-passphrase, --print)
trippy-mcp status        balances (bank-authoritative), policy budget, registration
trippy-mcp register      re-register / rename; --avatar <url|path> sets the profile image
trippy-mcp claim-code    mint a profile-link code
trippy-mcp identity <register|show|link|transfer>
                         the agent's ERC-8004 on-chain identity
trippy-mcp sweep <asset> <amount|all>
trippy-mcp export-key --yes-i-understand

Config (~/.trippy-mcp/config.json)

{
  "network": "mainnet",
  "agentName": "my-agent",
  "ownerSweepAddress": "0x…",        // immutable — the only sweep destination
  "policy": {
    "perTxCapUsd": 200,
    "dailyBudgetUsd": 1000,
    "maxSlippageBps": 300,
    "tradingEnabled": true,
    "allowUnpricedSpend": false,      // permit spends with no USD price; each one is charged
                                     // perTxCapUsd against the 24h budget, since an unpriced
                                     // spend that counted as $0 would bypass the budget entirely
    "airdropCapUsd": 1000            // max USD per airdrop campaign; 0 = airdrop tools not
                                     // registered at all — including `airdrop_manage`, so wind
                                     // down any live campaign before switching them off
  },
  "dryRun": false,
  "cw20Tokens": []                   // extra CW20 contracts `portfolio` should probe, on top of
                                     // the built-ins (SHROOM, dINJ, NONJA, hINJ, DOJO, COKE,
                                     // Pedro). A CW20 balance is not bank state and cannot be
                                     // enumerated from the chain, so a holding is only visible
                                     // if its contract is known up front — `quote`/`sell` handle
                                     // any CW20 fine, but `portfolio` can only show these
  // optional: rpcUrls, lcdUrl, pumpApiBase, choiceApiBase, gasBufferPct, gasPriceWei, referrer
}

Peculiaridades de Injective que este paquete maneja por ti

• eth_getBalance puede reportar 0 para cuentas con fondos en la RPC EVM de Injective — los saldos se leen del banco Cosmos (LCD), y un shim de transporte mantiene honesta la verificación previa de viem. Los exploradores/MetaMask pueden mostrar 0 para la billetera del agente; trippy-mcp status es autoritativo.

• El gas se cobra al límite, no al uso — el firmante estima y añade un pequeño margen en lugar de límites fijos.

• Las RPC públicas dan 502 intermitentemente y los recibos se retrasan — las solicitudes se reintentan entre puntos finales, y un recibo faltante desencadena una relectura del estado en lugar de un falso fallo.

• Los lanzamientos comienzan como Reserved hasta que el keeper los vincula (~segundos): create_token espera y reporta honestamente.

Desarrollo

npm ci && npm run typecheck && npm test && npm run build
node scripts/sync-abi.mjs --check     # ABI-drift guard against the vendored artifact
SHROOM_REPO=../shroom_launchpad node scripts/sync-abi.mjs --refresh

Los lanzamientos se publican desde CI en una etiqueta v* (publicación confiable de npm a través de OIDC, por lo que no hay token y la procedencia es automática) — incrementa la versión, etiqueta, empuja.

Notas de diseño y pruebas:

• docs/DESIGN-protocol-docs-and-airdrops.md — por qué explain y los rieles de airdrop tienen la forma que tienen, las decisiones tomadas al construirlos, y el barrido completo de rieles que los ejecutó por primera vez contra una cadena (incluyendo cinco cosas que el código creía que la cadena contradecía).

• docs/TESTING-airdrops.md — cómo ejercitar los rieles en testnet sin tocar una instalación en vivo, y qué aún no está probado.

MIT