Cómo conectar BlockCypher a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → BlockCypher, instálalo sin clave, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

BlockCypher + Gemini

Datos públicos de blockchain de BlockCypher para Bitcoin, Litecoin, Dogecoin, Dash y Ethereum: estado de la cadena y estimaciones de comisiones, bloques, saldos de direcciones, historial de transacciones de direcciones, transacciones individuales y la mempool. Solo lectura, funciona sin token en el plan gratuito.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

(ninguna obligatoria; BLOCKCYPHER_TOKEN es opcional)

Paso 1 — Configurar el conector

Datos públicos, token opcional: la configuración lleva menos de un minuto. El conector lee datos públicos de blockchain de la BlockCypher API v1 (https://api.blockcypher.com/v1) para Bitcoin, Litecoin, Dogecoin, Dash y Ethereum. En el plan gratuito BlockCypher responde a estas llamadas de solo lectura sin token.

1. En la tienda de conectores, elige BlockCypher e instálalo. Deja BLOCKCYPHER_TOKEN vacía para el plan gratuito sin clave.
2. Opcional: regístrate en https://accounts.blockcypher.com y copia el token del panel en BLOCKCYPHER_TOKEN. Se envía como parámetro de consulta token. blockcypher_get_transaction_confidence lo necesita y, con un plan de pago, sube los límites.
3. Compruébalo con blockcypher_get_chain y la red btc/main: muestra la altura actual de la cadena de Bitcoin, el último bloque y las estimaciones de comisiones.

Redes: todas las herramientas reciben network como coin/chain: btc/main, ltc/main, doge/main, dash/main, eth/main, o las cadenas de prueba btc/test3, bcy/test y beth/test. Las direcciones de Ethereum se escriben sin 0x.

Qué lee: el estado de una cadena (altura, último bloque, número de transacciones sin confirmar y estimaciones de comisiones por kB); bloques por hash o altura, con los hashes de sus transacciones; el saldo de una dirección (confirmado, sin confirmar y final); el historial de una dirección, como referencias ligeras a transacciones, como salidas no gastadas (UTXO) o como transacciones completas; transacciones individuales con confirmaciones, comisiones, entradas y salidas; la probabilidad de que una transacción sin confirmar se confirme; y la mempool, las últimas transacciones que aún no están en un bloque.

Montos y horas: los montos siempre van en la unidad más pequeña. Bitcoin, Litecoin, Dogecoin y Dash tienen 100.000.000 de unidades por moneda (100.000.000 satoshi = 1 BTC), Ethereum tiene 10^18 wei por ether; la IA los convierte antes de citar un monto. Las horas son ISO 8601 en UTC. Las confirmaciones son la altura de la cadena menos la altura del bloque más 1.

Paginación: los historiales de direcciones llegan del más reciente al más antiguo. Mientras hasMore sea true, la IA vuelve a llamar con before igual a la altura de bloque más baja recibida; con after trae solo lo nuevo desde una altura conocida.

Solo lectura: todas las herramientas solo leen, así que no hay nada que confirmar y ninguna herramienta está desactivada al instalar. No se envía, firma ni crea nada.

Límites: el plan gratuito permite 3 solicitudes por segundo y 100 por hora, con o sin token, y 10 consultas de confidence por hora. La ventana horaria se reinicia en cada hora en punto UTC, y blockcypher_get_chain muestra cuántas llamadas quedan. La IA prefiere la llamada de saldo a la llamada completa de la dirección y mantiene las páginas pequeñas.

Errores comunes: 429 significa que se agotó el límite por hora o por segundo: espera a la siguiente hora en punto (UTC) o usa un token de pago. 404 significa una dirección, un hash o un bloque desconocido en esa red, a menudo una dirección de otra moneda. 401 en la llamada de confidence significa que falta el token o es incorrecto.

El conector no envía ni firma transacciones, no gestiona wallets, no registra webhooks, no lee assets (OAP) y no cubre los saldos de tokens de Ethereum (ERC-20).

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de BlockCypher.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuál es la altura actual de la cadena de Bitcoin, y qué comisión por kB sugiere BlockCypher ahora mismo?"
• "Aquí tienes una dirección de Bitcoin: ¿cuál es su saldo confirmado y sin confirmar en BTC?"
• "Lista las últimas 10 transacciones de esta dirección de Litecoin con fecha, monto y confirmaciones."
• "¿Cuántas confirmaciones tiene esta transacción, y qué comisión pagó?"
• "Muéstrame las salidas no gastadas (UTXO) de esta dirección de Dogecoin y su total en DOGE."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT