@blockrun/mcp

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

BlockRun MCP es un servidor de Model Context Protocol de código abierto que le da a Claude — y a cualquier agente compatible con MCP — 19 herramientas para datos en tiempo real y acciones reales: 79 LLMs, generación de imágenes y video, datos de mercados de predicción, búsqueda en vivo de web/X, consultas on-chain en 40 cadenas, y la capacidad de colocar apuestas reales, liquidadas en USDC, en Polymarket.

Pagas por llamada, y eliges cómo. El modo Wallet autentica con una firma y liquida cada llamada en USDC mediante el protocolo x402 — sin cuenta, sin tarjeta de crédito, sin suscripción, en Solana o Base. El modo Cuenta autentica con una clave API de BlockRun (brk_live_…) desde user.blockrun.ai, enruta las llamadas de servicio a través de api.blockrun.ai, y descuenta el crédito de cuenta financiado con tarjeta o transferencia según el uso exacto. Las mismas 19 herramientas en ambos modos. Licencia MIT.

🏆 Primero en su tipo — el bucle señal → operación en Claude Code

Lee las probabilidades en vivo de Polymarket y coloca la apuesta, desde una sola wallet de autocustodia, con pago por llamada. Ir a trading de Polymarket →

Por qué existe BlockRun MCP

Todas las demás integraciones de datos fueron construidas para desarrolladores humanos — crea una cuenta, copia una clave API en .env, añade una tarjeta de crédito, repite con cada proveedor.

BlockRun te da ambas vías de pago sin reconstruir la integración. Usa una wallet cuando el agente deba tener autocustodia de los fondos, o usa una clave de cuenta cuando un equipo quiera créditos financiados con tarjeta y un panel de control.

• Una wallet, todas las fuentes — 19 herramientas detrás de una sola wallet de autocustodia. Sin registros por proveedor.
• Una clave de cuenta, todas las fuentes — crea una clave en user.blockrun.ai, recárgala con tarjeta o transferencia, y el MCP llama a api.blockrun.ai con esa clave.
• Sin clave API en modo wallet — la firma de tu wallet es la autenticación.
• Sin tarjeta de crédito en modo wallet — paga por solicitud en USDC mediante x402, fracciones de centavo cada una.
• Empieza gratis — el nivel gratuito (blockrun_chat mode:"free", blockrun_dex, crypto blockrun_price, blockrun_models) cuesta $0.
• Lee y actúa — la mayoría de las herramientas entregan datos; blockrun_polymarket coloca operaciones reales, con confirmación previa.
• Pagos con intervención humana — activa BLOCKRUN_CONFIRM_SPEND=on y el agente se pausa antes de cualquier llamada de pago por encima de tu umbral; nada se firma hasta que lo apruebes. Detalles ↓
• UI generativa — en Claude Desktop, claude.ai, VS Code y Cursor, la vista previa de Polymarket es una tarjeta de orden en vivo con un botón de Colocar, y la wallet es un panel con saldos, QR y recarga con tarjeta. Apps MCP ↓
• Autocustodia — tu clave nunca sale de tu máquina (~/.blockrun/.session, 0600 — o el llavero del sistema operativo si optas por BLOCKRUN_KEYCHAIN=strict). BlockRun no puede mover tus fondos.

Cómo se compara

✓ Una wallet o una clave de cuenta · ✓ Pago por llamada · ✓ Lee y opera · ✓ Multi-cadena · ✓ Listo para agentes · ✓ Código abierto

Qué cambia

Antes de BlockRun, Claude no puede responder:

• "¿Cuál es la probabilidad actual en Polymarket de que Bitcoin alcance los $100k este año?"
• "Encuéntrame los 5 mejores papers sobre RAG publicados en los últimos 30 días."
• "¿Qué está diciendo la gente sobre @sama en X ahora mismo?"
• "¿Cuál es el volumen de 24h del par PEPE/ETH en Uniswap?"
• "Polymarket tiene a la Fed manteniendo tasas al 73% — pon $2 en eso." ← y ahora puede colocar la operación, no solo leer las probabilidades.

Después de BlockRun, puede. Cada consulta cuesta fracciones de centavo — facturadas desde una wallet USDC local, o desde crédito financiado con tarjeta en una cuenta de BlockRun a través de api.blockrun.ai. Sin suscripciones, sin registros por proveedor.

Inicio rápido

0. Elige cómo pagas

Ambos modos llegan a las mismas 19 herramientas. El modo Cuenta envía llamadas de servicio a https://api.blockrun.ai por defecto. Puedes cambiar en cualquier momento; establecer BLOCKRUN_API_KEY tiene prioridad sobre una wallet, y al desactivarlo la wallet vuelve a estar activa.

1. Instalación

Claude Code (recomendado)

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

-s user se instala globalmente (disponible en todos los proyectos). El separador -- asegura que -y se pase a npx, no que lo analice claude mcp add.

💡 Usuarios de Homebrew / nvm: si el servidor no se conecta, es probable que Claude Code no encuentre node/npx en su PATH de lanzamiento. Pasa tu PATH de shell — funciona en CLI y escritorio:

claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest

Consulta Solución de problemas si persiste.

Cada cliente MCP — un comando o un bloque JSON. Verificado = ejecutamos el paquete publicado en ese cliente y vimos las herramientas listadas (versión del cliente · fecha). Documentado = ruta de instalación de la documentación del propio cliente; aún no probado por nosotros — cuéntanos si funciona. La columna Diálogo de gasto indica si el cliente renderiza el aviso de pago con intervención humana; en clientes ❌ las llamadas de pago proceden sin preguntar y BLOCKRUN_BUDGET_LIMIT es la protección.

Cualquier otro cliente MCP que pueda ejecutar un servidor stdio funciona igual: command: npx, args: ["-y", "@blockrun/mcp@latest"]. Con Node de nvm/Homebrew en un cliente configurado por JSON, pon la ruta absoluta de which npx en command. Fuentes del diálogo de gasto y qué significa "procede sin preguntar": docs/spend-confirmation.md.

Grok — aumenta el tiempo de espera de inicio antes de instalar, o la primera ejecución parecerá rota. Grok espera startup_timeout_sec a que un servidor MCP responda, y el valor predeterminado es 30 (documentación MCP de xAI). Una primera ejecución de npx -y tiene que descargar este paquete y su árbol de dependencias antes de que el servidor pueda decir nada, y eso es una carrera: medido en frío, con caché npm vacía, tomó 17s en una conexión rápida y 42-46s en una máquina compartida más lenta. Si pierdes la carrera, grok mcp doctor blockrun dice server timed out (no response within 30s) y la UI muestra blockrun [unavailable] — una instalación que está funcionando, agotando el tiempo de espera e indistinguible de una rota.

Dale espacio en ~/.grok/config.toml (o .grok/config.toml para un proyecto):

[mcp_servers.blockrun]
command = "npx"
args = ["-y", "@blockrun/mcp@latest"]
enabled = true
startup_timeout_sec = 120

O evita por completo la descarga en frío, que es más rápida en cada ejecución después de la primera:

npm install -g @blockrun/mcp@latest
grok mcp add blockrun -- blockrun-mcp

Solo la PRIMERA ejecución paga esto: npx almacena en caché por especificación exacta, así que el siguiente arranque es rápido (~9s aquí). La misma trampa existe en cualquier cliente con un tiempo de espera de arranque — si una instalación nueva aparece como no disponible y npx -y @blockrun/mcp@latest funciona bien en una terminal, aumenta el tiempo de espera del cliente o instala globalmente antes de buscar otra cosa. Gracias a @0xCheetah1 por el informe.

OpenClaw: el paquete publicado npx fue verificado de extremo a extremo el 2026.8.2: las 20 herramientas fueron proyectadas (19 desde la exclusión de Surf), las llamadas gratuitas funcionaron y las llamadas pagadas x402 se liquidaron. Añade un límite estricto de sesión al instalar:

openclaw mcp set blockrun '{"command":"npx","args":["-y","@blockrun/mcp@latest"],"env":{"BLOCKRUN_BUDGET_LIMIT":"2"}}'
openclaw mcp doctor blockrun --probe

La confirmación de gasto depende del runtime de OpenClaw y de la superficie de chat. Su harness Codex soporta la elicitación de formularios MCP, pero una solicitud no mapeable se devuelve como un rechazo explícito; en la ruta WebChat → Codex probada aquí, BLOCKRUN_CONFIRM_SPEND=on rechazó llamadas pagadas sin presentar un diálogo accionable. Mantén la confirmación desactivada en esa ruta y confía en BLOCKRUN_BUDGET_LIMIT más el modo de aprobación de herramientas propio de OpenClaw.

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

2. Elige un perfil de herramientas (opcional)

Expón un conjunto de herramientas recortado para que el cliente cargue menos esquemas en el contexto. Pasa --profile <name> (o establece BLOCKRUN_MCP_PROFILE); omítelo para el conjunto completo.

blockrun_surf fue eliminado en 0.49.0: la puerta de enlace ha respondido a cada ruta de Surf (asksurf.ai) con 410 desde 2026-09-06, por lo que la herramienta solo podía devolver un error, y su esquema costaba contexto de agente en cada turno. Esas preguntas van a blockrun_price, blockrun_defi, blockrun_markets y blockrun_dex; la habilidad surf mapea cada endpoint anterior a su reemplazo.

claude mcp add blockrun-trading -s user -- npx -y @blockrun/mcp@latest --profile trading

# Codex CLI
codex mcp add blockrun-trading -- npx -y @blockrun/mcp@latest --profile trading

Un nombre de perfil desconocido cae en full. modal y phone son solo del perfil full.

Cuánto cuesta cada perfil en tu contexto

Instalar un servidor MCP gasta contexto en cada turno, llames o no a las herramientas — el cliente carga el esquema de cada herramienta en el prompt del modelo y lo reenvía durante toda la sesión. Los gestores de paquetes han mostrado el tamaño de instalación durante décadas. Casi ningún servidor MCP muestra esto. El nuestro:

Ejecutar --profile trading en lugar del predeterminado cuesta 59% menos contexto para el mismo flujo de trabajo de trading. Si solo preguntas sobre mercados, ese es el cambio más barato que puedes hacer.

Mídelo tú mismo — contra nosotros, o contra cualquier otro servidor MCP stdio:

npm i gpt-tokenizer
node scripts/measure-tool-schema.mjs                     # this server, every profile
node scripts/measure-tool-schema.mjs -- npx -y @some/other-mcp-server

3. Añade fondos

Opción A — clave API + crédito de cuenta (sin wallet). Inicia sesión en user.blockrun.ai con Google. Este es el panel para claves, créditos y actividad; el MCP usa la clave para llamar a api.blockrun.ai para los servicios reales.

1. Panel → Claves — crea una clave. Se ve como brk_live_… y se muestra una sola vez.
2. Panel → Créditos — recarga con tarjeta de crédito o transferencia bancaria.
3. Apunta el servidor a ella. Por defecto, las llamadas en modo cuenta van a https://api.blockrun.ai:

claude mcp add blockrun -s user -e BLOCKRUN_API_KEY=brk_live_… -- npx -y @blockrun/mcp@latest

O export BLOCKRUN_API_KEY=brk_live_… en el entorno desde el que el cliente se lanza.

Si tu cliente hace incómodas las variables de entorno, escribe la clave en ~/.blockrun/.api-key en su lugar (chmod 600) — el mismo directorio de archivos que usa el wallet. La variable de entorno gana cuando ambas están presentes. 4. Panel → Actividad — cada llamada, con precio por uso exacto.

Verifica con blockrun_wallet action:"status" — reporta la cuenta, su saldo real y lo que esta sesión ha gastado:

Paying with: BlockRun account API key (no wallet, no chain)

  Account:  acme (gated)
  Credit remaining: $12.5000 of $50.00 granted
  Top up:   https://user.blockrun.ai/dashboard/credits

Las cuentas con facturación muestran Spent to date: $4.5239 (invoiced account — no prepaid ceiling) en su lugar. Si la cuenta está bloqueada, el estado lo dice y por qué antes de que gastes una llamada para descubrirlo.

Opción B — wallet (sin cuenta). Ejecuta blockrun_wallet para ver tus direcciones. Las instalaciones nuevas usan Solana por defecto; envía USDC (SPL) en Solana desde Coinbase (elige "Solana"), Phantom, Solflare o Backpack. Para pagar en Base en su lugar: blockrun_wallet action:"chain" chain:"base", luego envía USDC en Base. Instrucciones completas: Financia tu wallet.

$5 cubre ~525 consultas de mercado · ~500 búsquedas Exa · ~250 generaciones de imágenes · ~14 clips de Seedance 1.5-pro.

4. Pregúntale a Claude cualquier cosa

"¿Qué dice Polymarket sobre la próxima decisión de la Fed? Si 'mantener' está por encima del 70%, pon $2 en ello."

Claude lee las probabilidades con blockrun_markets. En modo wallet, y solo después de tu confirmación, también puede colocar la operación con blockrun_polymarket. En modo clave API, las llamadas de datos/medios/investigación pasan por api.blockrun.ai; el trading de Polymarket aún requiere un par de claves local para firmar.

5. Instala las habilidades del agente (opcional)

El paquete incluye 17 habilidades — qué herramienta responde qué, ejemplos prácticos y un trío de configuración / depuración / actualización para que el agente pueda instalar, solucionar problemas y actualizar el servidor por sí mismo.

/plugin marketplace add BlockRunAI/blockrun-mcp            # Claude Code
npx -y @blockrun/mcp@latest skills install                 # any project → ./.claude/skills
npx -y @blockrun/mcp@latest skills install --global        # ~/.claude/skills
npx -y @blockrun/mcp@latest skills install --to ~/.codex/skills

skills list muestra lo que incluye; --only a,b elige; --force refresca las copias después de una actualización.

Demo

Usuario: ¿Qué dice Polymarket sobre la decisión de tasa de la Fed el próximo mes?

Claude: Según Polymarket, el mercado pone una probabilidad del 73% en que la Fed mantenga las tasas estables, 24% en un recorte de 25pb, 3% en una subida. Volumen 24h: $2.1M. El contrato "Hold" se negoció por última vez a $0.73.

(vía blockrun_markets · costo: $0.0085 en Base — $0.0075 + la tarifa de red de $0.001)

Usuario: Polymarket tiene a Hawley en ~13% para anunciar una candidatura presidencial 2026 — pon $1 en Sí.

Claude: Hecho — compré 7.63 acciones de Sí a $0.131 ($1.00, mercado FOK). Orden real en cadena, liquidada en pUSD desde tu wallet de depósito Polymarket sin gas; estoy rastreando la posición ahora.

(señal vía blockrun_markets, operación vía blockrun_polymarket — un wallet de autocustodia, sin gas · tx en cadena 0x7ca8…)

Herramientas

Los precios planos de datos son la base. En modo wallet, la puerta de enlace añade su tarifa de red plana encima — $0.001 por llamada en Base hoy, y la puerta de enlace de Solana cotiza solo la base; el carril de cuenta no cobra tarifa. La cifra exacta está en el encabezado payment-required de cualquier solicitud no pagada, que es gratis pedir. El servidor reserva $0.002 para la tarifa contra el límite de presupuesto, así que blockrun_wallet action:"report" y el diálogo de confirmación de gasto corren $0.001 más por llamada por diseño.

Casos de uso clave

1. Consenso de mercados de predicción → "¿Las probabilidades de Polymarket para la próxima decisión de la Fed?" — blockrun_markets
2. Señal → operación (el ciclo completo, autocustodia) → "Si 'mantener' está por debajo del 30%, pon $2 en Sí." — blockrun_markets lee, blockrun_polymarket action:"buy" coloca. Sin gas, con confirmación.
3. Análisis forense de dinero inteligente → "Esta ballena de Polymarket — ¿quién es, qué wallets son suyas, cuál es su P&L?" — blockrun_markets polymarket/wallet/identity/:wallet + .../cluster
4. Investigación citada → "Los 5 artículos más citados sobre decodificación especulativa, últimos 90 días." — blockrun_exa
5. Generación de imágenes con texto en la imagen → "Póster anunciando GPT-5.5, retro-futurista, titular 'NOW LIVE'." — blockrun_image
6. Dale voz a tu agente → "Di esto con la voz de sarah." — blockrun_speech
7. Llamada de voz saliente → "Llama al +1-415-… y confirma el viernes a las 3pm." — blockrun_phone
8. Investigación multiagente, con tope → "Lanza 3 agentes sobre narrativas L1 competidoras. Tope de $0.50 para cada uno." — blockrun_wallet delegate × 3
9. Lecturas de cadena en bruto, 40 cadenas → "Último bloque de Base, y el saldo USDC de este contrato." — blockrun_rpc

📈 Trading en Polymarket

blockrun_polymarket permite a un agente colocar apuestas reales en Polymarket (CLOB V2, Polygon). Es no custodial: cada orden y aprobación se firma localmente con EIP-712 mediante tu clave de wallet BlockRun — la misma clave de autocustodia que paga las tarifas de API x402 en Base también autoriza apuestas en Polygon. Ni BlockRun ni el relayer de Polymarket pueden mover fondos; solo reenvían los payloads que tú firmaste.

Arquitectura — la ruta oficial de "deposit wallet" (tipo de firma POLY_1271): una bóveda de contrato inteligente en Polygon, derivada de CREATE2 a partir de tu clave (solo tu clave puede autorizarla), mantiene los fondos de apuestas en pUSD (el wrapper de colateral 1:1 de Polymarket). El despliegue, las aprobaciones y los reembolsos se ejecutan todos sin gas a través del relayer de Polymarket — nunca necesitas POL.

📖 Guía completa paso a paso: docs/polymarket-trading-setup.md

# 1. Provision your deposit wallet (idempotent, gasless)
blockrun_polymarket action:"setup"

# 2. Fund it from your Base USDC in one call (gasless; $0.01 fee, non-custodial)
blockrun_polymarket action:"fund" amount_usd:5 confirm:true

# 3. Sign the one-time gasless approval batch
blockrun_polymarket action:"setup" confirm:true

# 4. Find a market, preview safely, then place only after exact user approval
blockrun_polymarket_read action:"preview" side:"buy" token_id:"<id>" amount_usd:5 order_type:"FOK"
blockrun_polymarket action:"buy" token_id:"<id>" amount_usd:5 order_type:"FOK" confirm:true

# 5. Manage → positions · orders · cancel · sell · redeem · withdraw

Barreras de seguridad (del lado del servidor; un agente no puede evadirlas): confirm:true requerido para cada orden/aprobación/reembolso, POLYMARKET_MAX_BET_USD tope por orden (por defecto $25), POLYMARKET_MAX_SESSION_USD tope de sesión opcional, y las apuestas nunca se descuentan del presupuesto de API x402.

Regiones: Polymarket bloquea geográficamente la colocación de órdenes por IP (EE. UU./Reino Unido y muchas regiones). Gestionado por defecto — el MCP enruta el tráfico CLOB a través del egress alojado de BlockRun en Finlandia (una región totalmente sin restricciones según la política de Polymarket), por lo que el trading funciona de inmediato; setup informa tu estado. Anula POLYMARKET_CLOB_HOST para ir directo o ejecutar tu propio egress, opcionalmente alcanzado mediante HTTPS_PROXY / POLYMARKET_CLOB_PROXY (un proxy solo no cambia el egress visible para Polymarket). Cumplir con los términos de Polymarket para tu jurisdicción es tu responsabilidad.

⚠️ Haz una copia de seguridad de tu clave de firma (~/.blockrun/.session por defecto; una BLOCKRUN_WALLET_KEY variable de entorno o un agente existente wallet.json tiene prioridad — setup imprime la dirección real del firmante). Es la única clave tanto para la wallet de pago como para la wallet de depósito de Polymarket.

🛡️ Pagos con intervención humana

Activa BLOCKRUN_CONFIRM_SPEND=on y cada herramienta de pago se pausa antes de firmar. El servidor envía una elicitación MCP; tu cliente la muestra como un diálogo con el cargo estimado:

💸 BlockRun charge — video · bytedance/seedance-2.5 · 10s
Estimated: $2.6500
Approve this spend? (USDC is debited per call.)
To stop the charge, choose Decline — Cancel/ESC lets it proceed.

[ ] Approve all BlockRun charges for the rest of this session (don't ask again)

                                          [ Decline ]  [ Approve ]

Rechazar → no se envía nada, no se cobra nada, la herramienta informa "Cargo rechazado". Aprobar → la llamada continúa. Marca la casilla y no se te volverá a preguntar durante la sesión. Las llamadas gratuitas nunca preguntan. Configura BLOCKRUN_CONFIRM_THRESHOLD=0.05 para que solo se te pregunte por encima de $0.05.

claude mcp add blockrun -s user -e BLOCKRUN_CONFIRM_SPEND=on -e BLOCKRUN_CONFIRM_THRESHOLD=0.05 -- npx -y @blockrun/mcp@latest

En un cliente que no puede preguntar, la compuerta falla abierta — la llamada continúa y el pie de costo informa el cargo. El límite estricto en todos los clientes es el presupuesto: BLOCKRUN_BUDGET_LIMIT para el proceso, blockrun_wallet action:"delegate" por subagente. blockrun_polymarket mantiene su propio confirm:true por orden, más estricto.

📖 Cuándo usarlo, fuentes para la matriz, limitaciones: docs/spend-confirmation.md

🧩 MCP Apps — tarjeta de orden y panel de wallet

En hosts que admiten la extensión MCP Apps — Claude Desktop, claude.ai, VS Code, Cursor, ChatGPT — dos herramientas se muestran como tarjetas interactivas en lugar de texto. En cualquier otro lugar (Claude Code, Codex, terminales) nada cambia.

• Tarjeta de orden en blockrun_polymarket_read action:"preview" — pregunta, resultado, lado, mejor cotización, acciones estimadas, nocional, medidor de tope, registro de sesión. Edita el monto → Re-cotizar. Colocar orden es armar-y-luego-confirmar y pide al host llamar a blockrun_polymarket … confirm:true, por lo que el aviso de consentimiento del host y todos los topes del servidor (POLYMARKET_MAX_BET_USD, tope de sesión) siguen aplicándose.
• Panel de wallet en blockrun_wallet — saldos de ambas cadenas, cambiar de cadena, copiar dirección, QR EIP-681 / Solana Pay, explorador, Comprar USDC con tarjeta.

📖 Hosts, ruta del dinero, pruebas locales: docs/mcp-apps.md

Financia tu wallet

¿Pagando con una clave API? No hay wallet que financiar — recarga crédito con tarjeta o transferencia en user.blockrun.ai/dashboard/credits. El MCP usará esa clave contra api.blockrun.ai y omitirá por completo la vía de wallet.

El servidor mantiene dos wallets — una en Solana, una en Base — y paga desde una a la vez. Ejecuta blockrun_wallet para ver ambas direcciones, saldos y cuál está activa.

$5 cubren ~525 consultas de mercado, ~500 búsquedas de Exa, ~250 generaciones de imágenes, o ~14 clips de Seedance 1.5-pro (5s @ 720p+audio, ~$0.35 cada uno).

Paga en Solana (predeterminado para instalaciones nuevas)

blockrun_wallet action:"setup"    # shows the Solana address + funding QR

Envía USDC (SPL) en la red Solana — desde Coinbase (elige "Solana"), Phantom, Solflare o Backpack.

Paga en Base

Una sola llamada de herramienta — sin variables de entorno, sin editar archivos, sin reiniciar:

blockrun_wallet action:"chain" chain:"base"   # provisions + activates the Base wallet
blockrun_wallet action:"setup"                # shows the Base address + funding QR

Vuelve a cambiar con blockrun_wallet action:"chain" chain:"solana". Cambiar solo modifica qué wallet paga; ambas mantienen sus saldos.

¿Actualizando desde una versión anterior? Nada se mueve. El predeterminado de Solana primero aplica solo a instalaciones sin wallet y sin preferencia de cadena guardada — si ya tienes una wallet de Base, permaneces en Base hasta que cambies.

Qué alcanza cada modo

Casi todo se liquida ahora en cualquiera de las dos cadenas. Las excepciones:

Una capacidad bloqueada devuelve un mensaje que nombra la solución, no un error en bruto.

Cuánto cuesta una llamada, y qué tan seguros estamos

Cualquier estimación se imprime con un ~ y lo indica. Las estimaciones tienden a ser altas en la vía de cuenta — añaden una tarifa de transacción que no se cobra — por lo que un tope de presupuesto se activa antes en lugar de tarde. La fuente de verdad es siempre Dashboard → Actividad.

Para agentes y LLMs

Si eres un LLM que invoca herramientas MCP de BlockRun, lee esto primero:

• CRÍTICO: Ante cualquier error de pago / saldo / 402, llama a blockrun_wallet primero para verificar el estado, luego action:"setup" para financiar. No reintentes la herramienta fallida a ciegas — la wallet está vacía.
• CRÍTICO: blockrun_polymarket mueve fondos REALES del usuario (pUSD en Polygon), separados del presupuesto de API x402. Nunca buy/sell/redeem con confirm:true a menos que el usuario haya aprobado explícitamente esa operación exacta; sin confirm obtienes una ejecución de prueba segura. Descubre mercados/IDs de tokens con blockrun_markets primero.
• CRÍTICO: blockrun_music y blockrun_video son asíncronos con pago al completar. Los fallos / tiempos de espera del cliente NO cobran. No hagas bucles de reintento — pueden tardar 60–180s.
• CRÍTICO: Antes de generar agentes hijos, asigna presupuesto por agente: blockrun_wallet action:"delegate" agent_id:"X" agent_limit:1.00, luego pasa agent_id:"X" a cada llamada posterior. El hijo se bloquea automáticamente en cero.
• Nivel gratuito primero para borradores: blockrun_chat mode:"free" (NVIDIA), blockrun_dex, blockrun_price (cripto/FX/commodities) y blockrun_models son $0.
• Una confirmación de gasto rechazada es la decisión del usuario. Infórmalo y detente — nunca vuelvas a emitir la llamada con un modelo más barato, parámetros más pequeños o solicitudes divididas para quedar por debajo de su umbral.

Vitrina

Pósters generados mediante blockrun_image con openai/gpt-image-2 — cada uno una sola llamada API enrutada a través de BlockRun, pagada con crédito de cuenta o una wallet USDC.

Conferencia Blockchain de Cornell 2026	Conferencia Blockchain de Cornell 2026	100 Billones de Tokens hito

Los prompts y un ejemplo trabajado están en skills/image-prompting/SKILL.md.

¿Por qué no usar simplemente las APIs directamente?

Una wallet, o una clave API respaldada por dashboard. Todas las fuentes.

Configuración

Solución de problemas

🤖 Entrégale esto al agente: la habilidad blockrun-debug contiene cada fila a continuación como síntoma → causa → solución, además de los diagnósticos que puede ejecutar por sí misma. blockrun-setup y blockrun-upgrade cubren las otras dos mitades. Instalación: npx -y @blockrun/mcp@latest skills install.

• Insufficient balance / HTTP 402 después de reintentar → Ejecuta blockrun_wallet action:"setup", envía USDC en Base (o Solana).
• blockrun no se conecta / "MCP server failed" / spawn npx ENOENT → Casi siempre es un problema de PATH: Claude Code no puede encontrar node/npx en el PATH de su lanzador (común con Homebrew / nvm, tanto en CLI como en escritorio). Solución: pasa el PATH de tu shell en la instalación:

  claude mcp remove blockrun -s user
  claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest
  

  Luego reinicia Claude Code. O fija rutas absolutas (which npx).
• claude mcp list no muestra blockrun → Verifica node -v (≥20.19). Limpia la caché de npx: rm -rf ~/.npm/_npx. Vuelve a ejecutar la instalación.
• fetch failed / tiempo de espera en la verificación de saldo → Interrupción transitoria del RPC de Base. La herramienta prueba con 3 RPC públicos; reintenta después de 30s. Persistente = proxy local / firewall bloqueando el RPC saliente.
• Video/Music generation timed out → Congestión de cola ascendente. Si costó algo depende del riel, y el error indica cuál: en la wallet de Base el pago se liquida al completarse, por lo que no se cobra y reintentar es seguro; en música de Solana y cada trabajo de medios del riel de cuenta la pasarela factura al enviar, por lo que el trabajo sí se cobra, el error lo nombra, y volver a ejecutarlo factura un segundo — revisa blockrun_wallet action:"report" en su lugar.
• blockrun_price dice Equity quotes are not served (gateway 501 …) → Los precios/historial de acciones se retiraron el 2026-09-05; no es una interrupción, y no se cobró nada (nunca se pide a la wallet que firme). El catálogo de tickers (action:"list" category:"stocks") sigue siendo gratuito. Cobertura de acciones: hello@blockrun.ai.
• blockrun_markets en sports/* falla — antes de 0.49.0 como API error after payment: 502 sin cambio de saldo → Las rutas sports/* de Predexon han estado caídas aguas arriba desde 2026-08-04; la pasarela libera el pago en ese 500 ascendente, por lo que la llamada no se cobra (el error lo dice cuando la confirmación de "pago NO cobrado" de la pasarela está en la respuesta; de lo contrario te indica revisar blockrun_wallet action:"report"). Para cuotas deportivas usa path:"markets/search" con params:{ q: "NBA" }, o polymarket/events con params:{ search: "NBA" } — la ruta simple markets y su filtro league se eliminaron aguas arriba el 2026-08-04 y dan 404 antes del pago. Actualiza a ≥ 0.49.0 para que el error diga todo esto por sí mismo.
• Sin diálogo de confirmación de gasto aunque BLOCKRUN_CONFIRM_SPEND=on → Tu cliente no admite elicitación de MCP (Windsurf, Codex, Gemini CLI); el servidor continúa sin preguntar por diseño. Usa BLOCKRUN_BUDGET_LIMIT como protección, o un cliente de la tabla de soporte.
• Polymarket: falla la compra en mercado de riesgo negativo ("winner"), o redeem revierte, aunque la configuración muestre listo → Vuelve a ejecutar action:"setup" confirm:true una vez (otorga las aprobaciones en cadena que una wallet de depósito anterior a la actualización puede no tener — incluidas las aprobaciones del adaptador de colateral que redeem necesita). Consulta la guía de configuración.

Preguntas frecuentes

¿Qué es BlockRun MCP? Un servidor MCP de código abierto que brinda a Claude y otros agentes 19 herramientas para datos en tiempo real y acciones reales (trading, medios, en cadena), con pago por llamada — desde una wallet de autocustodia o una clave de cuenta de BlockRun.

¿Necesito una clave API o una cuenta? No. Se crea automáticamente una wallet localmente en el primer inicio; la financias con USDC y no hay registros, paneles ni claves que rotar.

Pero puedes tener una. Si tu equipo no puede entregar una wallet a un agente, inicia sesión en user.blockrun.ai, crea una clave en Dashboard → Keys, recarga crédito de cuenta con tarjeta o transferencia en Dashboard → Credits, y define BLOCKRUN_API_KEY. El MCP entonces envía llamadas de servicio de pago a api.blockrun.ai y factura el uso exacto contra ese crédito de cuenta — sin tarifa de red de $0.001 por llamada, sin mínimo por llamada — con un libro mayor en Dashboard → Activity. Todo funciona excepto las partes que realmente necesitan un par de claves: trading en Polymarket, saldos/recargas de wallet, y el blockrun_realface action:"list" indexado por wallet.

¿Cuál es más barato? La facturación de cuenta, ligeramente — cobra uso medido exacto sin mínimo por llamada y sin tarifa de transacción de $0.001. El modo wallet te da autocustodia y trading en Polymarket en su lugar.

¿Cuánto cuesta? Pago por llamada — fracciones de centavo a unos pocos centavos. El nivel gratuito (blockrun_chat mode:"free", blockrun_dex, cripto blockrun_price, blockrun_models) es $0. $5 de USDC o crédito de cuenta cubre miles de consultas.

¿Es seguro / no custodial? Sí. Tu clave privada nunca sale de tu máquina (~/.blockrun/.session por defecto, 0600). Los pagos x402 y las órdenes de Polymarket se firman localmente — BlockRun reenvía payloads firmados y no puede mover tus fondos.

¿Qué clientes funcionan? Cualquier cliente MCP que pueda lanzar un servidor stdio. Verificado en Claude Code y Codex CLI, en uso diario en OpenClaw; rutas de instalación documentadas para Claude Desktop, Cursor, VS Code, Gemini CLI y Windsurf — consulta la tabla de clientes. El diálogo de confirmación de gasto además necesita elicitación de MCP (Claude Code, Cursor, VS Code).

¿Tiene interfaz? En hosts de MCP-Apps (Claude Desktop, claude.ai, VS Code, Cursor) la vista previa de Polymarket es una tarjeta de orden en vivo y la wallet es un panel — consulta MCP Apps ↑. Los clientes de terminal reciben la misma información como texto.

¿Puedo hacer que el agente pregunte antes de gastar? Sí — BLOCKRUN_CONFIRM_SPEND=on. Cada herramienta de pago se pausa con el cargo estimado y nada se firma hasta que apruebes. Pagos con intervención humana ↑

¿Realmente puede hacer apuestas reales? Sí. blockrun_polymarket coloca órdenes reales liquidadas en USDC en el CLOB de Polymarket — con confirmación y límite. Lee las cuotas con blockrun_markets, coloca con blockrun_polymarket.

¿Base o Solana? Ambas. Cambia al instante con blockrun_wallet action:"chain". Tres cosas son solo de Base, y cada una lo dice cuando las llamas en Solana: blockrun_defi (DefiLlama) y blockrun_modal, que la pasarela de Solana no sirve, y el chat claude-* con thinking (la ruta nativa /v1/messages paga en Base; una llamada simple claude-* toma la ruta de compatibilidad en Solana). Generación de medios, mercados, búsqueda y Polymarket se liquidan en cualquiera de las dos cadenas.

Del ecosistema BlockRun

BlockRun es infraestructura de IA nativa para agentes — una wallet con micropagos x402 en USDC, o una clave API de cuenta con crédito financiado con tarjeta, en cada superficie:

• ⚡ ClawRouter — el enrutador de LLM nativo para agentes de OpenClaw. 79 modelos, enrutamiento local <1ms, USDC en Base y Solana.
• 🤖 BRCC — BlockRun para Claude Code: enrutamiento inteligente + pagos x402, diseñado específicamente para Claude Code.
• 🐍 ClawRouter-Hermes — plugin de Python que conecta NousResearch Hermes al proxy ClawRouter.
• 📚 Docs · Modelos y precios — SDKs completos, APIs y el catálogo de modelos.

Soporte y comunidad

Contribuciones

Se aceptan PRs. Consulta CONTRIBUTING.md para la configuración, la regla de diseño herramienta-vs-habilidad y cómo añadir una nueva API de socio.