Blockscout

oficial

Accede a datos de blockchain como saldos, tokens y NFTs desde las APIs de Blockscout. Compatible con múltiples cadenas y notificaciones de progreso.

¿Qué puedes hacer con Blockscout MCP?

  • Resolve direcciones y tokens — Pide a get_address_by_ens_name que convierta un nombre ENS en una dirección, o usa lookup_token_by_symbol para encontrar tokens por símbolo en distintas cadenas.
  • Inspecciona contratos y código — Usa get_contract_abi e inspect_contract_code para recuperar el ABI de un contrato inteligente o sus archivos fuente verificados.
  • Analiza la actividad de una wallet — Consulta get_transactions_by_address, get_token_transfers_by_address y nft_tokens_by_address para revisar el historial de transacciones, transferencias ERC-20 o tenencias de NFT de una dirección.
  • Explora bloques y transacciones — Obtén detalles mediante get_block_info y get_transaction_info, incluidos inputs decodificados, gas utilizado y transferencias de tokens.
  • Lee el estado de un contrato — Llama a read_contract para ejecutar funciones de solo lectura en un contrato inteligente en un bloque específico.
  • Accede a datos crudos de la cadena — Usa direct_api_call para consultas avanzadas o específicas de una cadena contra los endpoints de Blockscout.

Servidor MCP alojado

npx add-mcp 'https://mcp.blockscout.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de Blockscout

smithery badge

Blockscout Server MCP server

El Protocolo de Contexto de Modelos (MCP) es un protocolo abierto diseñado para permitir que agentes de IA, IDE y herramientas de automatización consuman, consulten y analicen datos estructurados a través de APIs conscientes del contexto.

Este servidor envuelve las APIs de Blockscout y expone datos de blockchain—saldos, tokens, NFTs, metadatos de contratos—a través de MCP para que agentes de IA y herramientas (como Claude, Cursor o IDE) puedan acceder y analizarlos contextualmente.

Características clave:

  • Acceso contextual a datos de blockchain para herramientas de IA
  • Soporte multi-cadena mediante la configuración de la API PRO de Blockscout con enriquecimiento de metadatos de Chainscout
  • API REST versionada: Proporciona una interfaz estándar y amigable para la web para todas las herramientas MCP. Consulta API.md para la documentación completa.
  • Instrucciones personalizadas para que el host MCP use el servidor
  • Optimización inteligente del contexto para conservar tokens de LLM mientras se preserva la accesibilidad de los datos
  • División inteligente de respuestas con tamaños de página configurables para prevenir el desbordamiento del contexto
  • Paginación con cursor opaco usando cadenas codificadas en Base64URL en lugar de parámetros complejos
  • Truncamiento automático de campos de datos grandes con indicadores claros y guía de acceso
  • Modelo de respuesta ToolResponse estandarizado con respuestas JSON estructuradas e instrucciones de seguimiento
  • Observabilidad mejorada con notificaciones de progreso MCP y actualizaciones periódicas para operaciones de larga duración

Análisis mejorado con habilidades de agente

Para un análisis de blockchain más potente y eficiente, instala la habilidad Blockscout Analysis del repositorio de habilidades de agente. Esta habilidad proporciona a los agentes de IA una guía estructurada para estrategias de ejecución, manejo de respuestas, mejores prácticas de seguridad y orquestación de flujos de trabajo.

Más información: Consulta el README de habilidades de agente para conocer todas las capacidades e instrucciones de instalación.

Configuración de clientes MCP

Clave de API PRO de Blockscout

Configurar el servidor MCP de Blockscout con un agente de IA requiere una clave de API PRO de Blockscout. La mayoría de las herramientas de datos enrutan sus solicitudes a través de la pasarela autenticada de la API PRO de Blockscout, por lo que sin una clave válida esas herramientas fallan rápidamente antes de realizar cualquier solicitud ascendente.

Para obtener una clave, regístrate en el Portal de desarrolladores de Blockscout (el nivel gratuito no requiere tarjeta de crédito) y genera una clave de API; las claves tienen el prefijo proapi_. Luego proporciónala al configurar tu cliente, como se muestra en las secciones siguientes.

Configuración de Claude (Web, Escritorio, Cowork) - Recomendado

La forma más fácil de usar el servidor MCP de Blockscout con Claude es el servidor alojado oficial: una experiencia de instalación nativa y gestionada con actualizaciones automáticas y sin necesidad de ejecutar nada tú mismo. Añádelo como un Conector Personalizado con tu propia clave de API PRO. Claude envía la clave en cada solicitud en un encabezado x-api-key, que el servidor acepta como un alias para su encabezado Blockscout-MCP-Pro-Api-Key.

  1. Abre Claude y ve a Personalizar > Conectores. En los planes Team y Enterprise, un propietario de la organización hace esto en Configuración de la organización > Conectores.
  2. Haz clic en Añadir conector personalizado. Establece el nombre como Blockscout y la URL como https://mcp.blockscout.com/mcp, luego continúa.
  3. Deja Autenticación como None (Claude lo detecta). Una advertencia de que el conector no tiene credenciales es esperada: la clave se proporciona en el siguiente paso.
  4. Abre Encabezados de solicitud, selecciona x-api-key de la lista y pega tu clave de API PRO como valor. Elige exactamente este nombre; el servidor no lee los otros nombres de apariencia similar en la lista.
  5. Haz clic en Añadir.

Nota: La sección Encabezados de solicitud está en versión beta y aún no está disponible para todas las organizaciones. Si tu diálogo no la muestra, usa el Directorio de conectores a continuación.

Nota: En los planes Team y Enterprise, la clave se ingresa una vez por el propietario y se comparte con toda la organización. La configuración de autenticación no se puede editar después de añadir un conector: para cambiar la clave, elimina el conector y añádelo de nuevo.

Uso del directorio de conectores de Claude

Si el diálogo de Conector Personalizado no tiene una sección de Encabezados de solicitud, instala el conector de Blockscout desde el Directorio oficial de conectores de Anthropic. Se conecta al mismo servidor alojado pero usa una clave de acceso compartida.

Instalación

Opción 1: Enlace directo

Visita claude.com/connectors/blockscout y haz clic en los enlaces de la sección "Usado en" para instalar el conector de Blockscout.

Opción 2: A través de la configuración
  1. Abre Claude (aplicación web o de escritorio)
  2. Ve a Configuración > Conectores > Explorar conectores
  3. Busca "Blockscout"
  4. Haz clic en "Conectar" para instalar

Limitaciones: Debido al uso de una clave de acceso compartida, puede haber restricciones en el acceso y las capacidades del conector.

Configuración de Claude Code

Pasa tu clave de API PRO a través del encabezado Blockscout-MCP-Pro-Api-Key al añadir el servidor:

claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp \
  --header "Blockscout-MCP-Pro-Api-Key: proapi_your_key_here"

Después de ejecutar este comando, Blockscout estará disponible como un servidor MCP en Claude Code, permitiéndote acceder y analizar datos de blockchain directamente desde tu entorno de codificación.

Configuración de aplicaciones de ChatGPT

Instala la aplicación Blockscout desde el mercado de aplicaciones de ChatGPT:

  1. Abre la página de la aplicación Blockscout (o busca "Blockscout" en el directorio de aplicaciones de ChatGPT).
  2. Haz clic en "Conectar" para habilitar la aplicación para tu cuenta de ChatGPT.

Configuración de la aplicación Codex

  1. Abre Codex y ve a Configuración > Servidores MCP > Añadir servidor.
  2. Establece Nombre como Blockscout, selecciona la pestaña HTTP Streamable y establece URL como https://mcp.blockscout.com/mcp.
  3. En Encabezados, añade un encabezado con clave Blockscout-MCP-Pro-Api-Key y valor proapi_your_key_here.
  4. Guarda y reinicia la aplicación Codex.

Configuración de Codex CLI

Codex CLI no puede adjuntar un encabezado personalizado desde la línea de comandos, así que configúralo en dos pasos:

  1. Crea la entrada del servidor:

    codex mcp add Blockscout --url https://mcp.blockscout.com/mcp
    
  2. Edita ~/.codex/config.toml para añadir el encabezado de la clave de API PRO y habilita el cliente MCP streamable-HTTP (requerido para que los servidores MCP remotos se conecten). La configuración resultante debería verse así:

    [features]
    experimental_use_rmcp_client = true
    
    [mcp_servers.Blockscout]
    url = "https://mcp.blockscout.com/mcp"
    http_headers = { "Blockscout-MCP-Pro-Api-Key" = "proapi_your_key_here" }
    

Configuración de Cursor

Añade el servidor a tu configuración MCP de Cursor — ya sea el .cursor/mcp.json a nivel de proyecto o el ~/.cursor/mcp.json global — proporcionando tu clave de API PRO a través del encabezado Blockscout-MCP-Pro-Api-Key:

{
  "mcpServers": {
    "blockscout": {
      "url": "https://mcp.blockscout.com/mcp",
      "timeout": 180000,
      "headers": {
        "Blockscout-MCP-Pro-Api-Key": "proapi_your_key_here"
      }
    }
  }
}

Configuración de desarrollo local (para desarrolladores)

Si quieres ejecutar el servidor localmente con fines de desarrollo:

{
  "mcpServers": {
    "blockscout": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "ghcr.io/blockscout/mcp-server:latest"
      ]
    }
  }
}

Detalles técnicos

Consulta SPEC.md para los detalles técnicos.

Estructura del repositorio

Consulta AGENTS.md para la estructura del repositorio.

Pruebas

Consulta TESTING.md para instrucciones completas sobre cómo ejecutar tanto pruebas unitarias como de integración.

Descripciones de herramientas

  1. __unlock_blockchain_analysis__() - Inicializa una sesión MCP de Blockscout: devuelve datos de referencia del servidor, el puntero de habilidad blockscout-analysis y la regla de resolución de URI. Llámala una vez por sesión, antes de cualquier otra herramienta.
  2. get_chains_list(query=None) - Devuelve una lista de cadenas compatibles, con filtrado opcional por nombre, ID de cadena, moneda nativa o ecosistema.
  3. get_address_by_ens_name(name) - Convierte un nombre de dominio ENS a su dirección de Ethereum correspondiente.
  4. lookup_token_by_symbol(chain_id, symbol) - Busca direcciones de tokens por símbolo o nombre, devolviendo múltiples coincidencias potenciales.
  5. get_contract_abi(chain_id, address) - Recupera el ABI (Interfaz Binaria de Aplicación) para un contrato inteligente.
  6. inspect_contract_code(chain_id, address, file_name=None) - Permite obtener los archivos fuente de contratos verificados.
  7. get_address_info(chain_id, address) - Obtiene información completa sobre una dirección, incluyendo saldo, asociación ENS, estado del contrato, detalles de tokens y etiquetas públicas.
  8. get_tokens_by_address(chain_id, address, cursor=None) - Devuelve tenencias detalladas de tokens ERC20 para una dirección con metadatos enriquecidos y datos de mercado.
  9. get_block_number(chain_id, [datetime]) - Recupera el número de bloque y la marca de tiempo para una fecha/hora específica o el último bloque.
  10. get_transactions_by_address(chain_id, address, age_from, age_to, methods, cursor=None) - Obtiene transacciones para una dirección dentro de un rango de tiempo específico con filtrado opcional por método.
  11. get_token_transfers_by_address(chain_id, address, age_from, age_to, token, cursor=None) - Devuelve transferencias de tokens ERC-20 para una dirección dentro de un rango de tiempo específico.
  12. nft_tokens_by_address(chain_id, address, cursor=None) - Recupera tokens NFT propiedad de una dirección, agrupados por colección.
  13. get_block_info(chain_id, number_or_hash, include_transactions=False) - Devuelve información del bloque, incluyendo marca de tiempo, gas utilizado, tarifas quemadas y número de transacciones. Opcionalmente puede incluir una lista de hashes de transacciones.
  14. get_transaction_info(chain_id, hash, include_raw_input=False) - Obtiene información completa de transacciones con parámetros de entrada decodificados y transferencias de tokens detalladas.
  15. read_contract(chain_id, address, abi, function_name, args='[]', block='latest') - Ejecuta una función de contrato inteligente de solo lectura y devuelve su resultado. El argumento abi es un objeto JSON que describe la firma de la función específica.
  16. direct_api_call(chain_id, endpoint_path, query_params=None, cursor=None, method='GET', json_body=None) - Llama a un endpoint de API de Blockscout en bruto para datos avanzados o específicos de la cadena. Admite solicitudes GET (predeterminado) y POST con cuerpo JSON.

Ejemplos de indicaciones para agentes de IA

Is any approval set for OP token on Optimism chain by `zeaver.eth`?
Calculate the total gas fees paid on Ethereum by address `0xcafe...cafe` in May 2025.
Which 10 most recent logs were emitted by `0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7`
before `Nov 08 2024 04:21:35 AM (-06:00 UTC)`?
Tell me more about the transaction `0xf8a55721f7e2dcf85690aaf81519f7bc820bc58a878fa5f81b12aef5ccda0efb`
on Redstone rollup.
Is there any blacklisting functionality of USDT token on Arbitrum One?
What is the latest block on Gnosis Chain and who is the block minter?
Were any funds moved from this minter recently?
When the most recent reward distribution of Kinto token was made to the wallet
`0x7D467D99028199D99B1c91850C4dea0c82aDDF52` in Kinto chain?
Which methods of `0x1c479675ad559DC151F6Ec7ed3FbF8ceE79582B6` on the Ethereum 
mainnet could emit `SequencerBatchDelivered`?
What is the most recent executed cross-chain message sent from the Arbitrum Sepolia
rollup to the base layer?

Desarrollo e implementación

Instalación local

Clona el repositorio e instala las dependencias:

git clone https://github.com/blockscout/mcp-server.git
cd mcp-server
uv pip install -e . # or `pip install -e .`

Para personalizar la parte inicial del encabezado User-Agent utilizado para solicitudes RPC, establece la variable de entorno BLOCKSCOUT_MCP_USER_AGENT (por defecto es "Blockscout MCP"). La versión del servidor se añade automáticamente.

Proporcionar la clave de API PRO al servidor

Cuando ejecutes el servidor tú mismo, proporciona la clave de API PRO de Blockscout a través de la variable de entorno BLOCKSCOUT_PRO_API_KEY — exportada en tu shell o colocada en un archivo .env ignorado por git en la raíz del proyecto. Esto habilita todo el acceso a datos, el enriquecimiento de etiquetas públicas y las lecturas de contratos. Nunca confirmes la clave ni la incrustes en un binario distribuido al cliente; cuando se ejecute a través de Docker, pásala en tiempo de ejecución (por ejemplo, -e BLOCKSCOUT_PRO_API_KEY=...) en lugar de incorporarla en la imagen.

export BLOCKSCOUT_PRO_API_KEY=proapi_your_key_here

Claves proporcionadas por el cliente (transportes HTTP). Cuando el servidor se ejecuta en modo HTTP, un cliente puede proporcionar su propia clave de API PRO en un encabezado de solicitud — por defecto Blockscout-MCP-Pro-Api-Key, configurable a través de BLOCKSCOUT_PRO_API_KEY_HEADER (establécelo en una cadena vacía para deshabilitar por completo las claves proporcionadas por el cliente). El servidor también lee la clave de un encabezado x-api-key, para clientes cuyos nombres de encabezado están restringidos a una lista fija (por ejemplo, Conectores Personalizados de Claude). El encabezado configurado tiene prioridad cuando ambos están presentes; x-api-key se consulta solo cuando el encabezado configurado falta o está en blanco, y deshabilitar las claves proporcionadas por el cliente también lo deshabilita. Esto funciona igual para ambos transportes HTTP — llamadas a herramientas MCP sobre HTTP y la API REST. Una clave proporcionada por el cliente tiene prioridad sobre BLOCKSCOUT_PRO_API_KEY para esa solicitud; si el cliente no envía ninguna clave, el servidor recurre a su propia clave configurada; si ninguna está presente, la solicitud falla con el error de no configurado. Una clave de cliente que está presente pero malformada hace fallar cualquier solicitud que necesite la API PRO sin recurso alternativo (el servidor nunca usa silenciosamente su propia clave en lugar de una clave de cliente defectuosa); las herramientas que no usan la API PRO no se ven afectadas. Esto hace posible ejecutar un servidor HTTP compartido donde cada cliente se autentica con su propia clave.

Advertencia de crédito bajo. El acceso a la API PRO se mide en créditos. Cuando el saldo restante informado por la API cae por debajo de un umbral configurable, cada herramienta de datos añade una nota de asesoramiento a su respuesta, instando a los operadores a recargar para que el acceso a la API PRO permanezca listo para un uso continuo de alto volumen. El umbral se establece a través de BLOCKSCOUT_PRO_API_LOW_CREDITS_THRESHOLD (por defecto 5000 créditos; establécelo en 0 para deshabilitar la nota). La nota se activa para cualquier saldo por debajo del umbral, incluyendo saldos cero y negativos. Aviso sobre el requisito de clave PRO API. BLOCKSCOUT_PRO_API_KEY_REQUIRED_NOTICE contiene un aviso configurado por el operador que el servidor añade como última entrada del campo notes de las respuestas de herramientas cuyas solicitudes no incluían la clave PRO API propia (bien formada) del cliente. Existe para anunciar la migración del servidor público oficial a claves proporcionadas por el cliente, por lo que solo se espera que la implementación oficial lo configure. Cuando la variable no está definida o está vacía (el valor predeterminado), la función está completamente desactivada. Los operadores comunitarios y autoalojados deben dejarla vacía, especialmente en modo stdio, donde usted configura BLOCKSCOUT_PRO_API_KEY usted mismo y ningún encabezado de solicitud puede llevar una clave de cliente; el aviso solo repetiría un mensaje de migración que no aplica a su implementación.

Ejecución del servidor

El servidor se ejecuta en modo stdio de forma predeterminada:

python -m blockscout_mcp_server

Modo HTTP (solo MCP):

Para ejecutar el servidor en modo HTTP Streamable (sin estado, respuestas SSE de forma predeterminada):

python -m blockscout_mcp_server --http

También puede especificar el host y el puerto para el servidor HTTP:

python -m blockscout_mcp_server --http --http-host 0.0.0.0 --http-port 8080

Modo de desarrollo (respuestas JSON simples):

Para desarrollo y pruebas con clientes HTTP simples (curl, Insomnia), puede habilitar respuestas JSON simples en lugar de flujos SSE:

export BLOCKSCOUT_DEV_JSON_RESPONSE=true
python -m blockscout_mcp_server --http

Nota: Esto desactiva Server-Sent Events (SSE) y las notificaciones de progreso. Úselo solo para pruebas y depuración locales.

Túneles con Ngrok (modo de desarrollo):

El SDK de Python MCP aplica protección contra el reenlace de DNS, que bloquea las solicitudes de túneles ngrok de forma predeterminada. Para habilitar túneles para desarrollo y pruebas:

  1. Inicie un túnel ngrok hacia su servidor local:

    ngrok http 8000
    
  2. Configure el host y el origen permitidos usando su URL de ngrok:

    export BLOCKSCOUT_MCP_ALLOWED_HOSTS="your-tunnel-id.ngrok-free.app"
    export BLOCKSCOUT_MCP_ALLOWED_ORIGINS="https://your-tunnel-id.ngrok-free.app"
    python -m blockscout_mcp_server --http
    

Nota: Estos ajustes son principalmente para uso en desarrollo. Cuando estas variables no están definidas, la protección contra el reenlace de DNS se determina automáticamente por el host de enlace del servidor: habilitada para localhost, deshabilitada para no localhost (por ejemplo, 0.0.0.0). Si su encabezado Host incluye un puerto no estándar, use el sufijo comodín :* (por ejemplo, "example.com:*") o especifique el valor exacto de host:puerto.

Para más detalles sobre túneles ngrok con servidores MCP, consulte la https://github.com/openai/openai-apps-sdk-examples/blob/main/README.md#testing-in-chatgpt.

Modo HTTP con API REST:

Para habilitar la API REST versionada junto con el endpoint MCP, use la bandera --rest (que requiere --http).

python -m blockscout_mcp_server --http --rest

Con host y puerto personalizados:

python -m blockscout_mcp_server --http --rest --http-host 0.0.0.0 --http-port 8080

Opciones de CLI:

  • --http: Habilita el modo HTTP Streamable.
  • --http-host TEXT: Host al que vincular el servidor HTTP (predeterminado: 127.0.0.1).
  • --http-port INTEGER: Puerto para el servidor HTTP (predeterminado: 8000).
  • --rest: Habilita la API REST (requiere --http).

Creación de la imagen Docker localmente

Inicialice el submódulo de habilidades incluido, hornee sus metadatos de commit en el contexto de compilación de Docker y luego compile la imagen:

git submodule update --init --recursive agent-skills
python scripts/bake_skill_metadata.py
docker build -t ghcr.io/blockscout/mcp-server:latest .

Extracción desde GitHub Container Registry

Extraiga la imagen precompilada:

docker pull ghcr.io/blockscout/mcp-server:latest

Ejecución con Docker

Modo HTTP (solo MCP):

Para ejecutar el contenedor Docker en modo HTTP con mapeo de puertos:

docker run --rm -p 8000:8000 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0

Con puerto personalizado:

docker run --rm -p 8080:8080 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0 --http-port 8080

Modo HTTP con API REST:

Para ejecutar con la API REST habilitada:

docker run --rm -p 8000:8000 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --rest --http-host 0.0.0.0

Nota: Cuando se ejecuta en modo HTTP con Docker, use --http-host 0.0.0.0 para vincularse a todas las interfaces y que el servidor sea accesible desde fuera del contenedor.

Con una clave PRO API de Blockscout:

Pase la clave en tiempo de ejecución con -e en lugar de incorporarla en la imagen (consulte Proporcionar la clave PRO API al servidor):

docker run --rm -p 8000:8000 -e BLOCKSCOUT_PRO_API_KEY=proapi_your_key_here \
  ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0

Con medición de sesiones habilitada (opcional):

La medición de sesiones limita cuántas llamadas a herramientas puede realizar un llamador sin una clave PRO API proporcionada por el cliente por identificador de sesión emitido por __unlock_blockchain_analysis__. Está desactivada de forma predeterminada. Habilitarla significa establecer un secreto de firma (al menos 32 bytes — genérelo, no lo invente), y requiere modo HTTP y una clave PRO API del lado del servidor (las llamadas medidas se atienden en el servidor con ella), además de un volumen persistente para la base de datos de sesiones. Genere el secreto una vez y guárdelo de forma duradera (un administrador de secretos o configuración de entorno persistente); cada reinicio y reimplementación debe pasar el mismo valor almacenado:

# Once, not per start: generate the secret and keep it.
BLOCKSCOUT_SESSION_SECRET="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"

docker run --rm -p 8000:8000 \
  -v blockscout-mcp-sessions:/data \
  -e BLOCKSCOUT_SESSION_SECRET="$BLOCKSCOUT_SESSION_SECRET" \
  -e BLOCKSCOUT_SESSION_DB_PATH=/data/sessions.db \
  -e BLOCKSCOUT_PRO_API_KEY=proapi_your_key_here \
  ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0

La mayoría de las implementaciones no necesitan nada de esto: deje BLOCKSCOUT_SESSION_SECRET sin definir (el valor predeterminado) y no se requiere volumen. Perder el volumen o rotar el secreto invalida los identificadores de sesión activos por diseño; la exposición está limitada por el TTL configurado. Regenerar el secreto en línea en cada docker run es la forma accidental de esa rotación: borra todos los identificadores activos en cada reinicio incluso si el volumen de la base de datos sobrevivió, así que nunca incruste el comando de generación en el comando de inicio. Restaurar una copia anterior de la base de datos revive los presupuestos que registró — después de una restauración histórica, rote el secreto a menos que eso sea intencional. Ajustes opcionales: BLOCKSCOUT_SESSION_MCP_MAX_CALLS y BLOCKSCOUT_SESSION_REST_MAX_CALLS (límites de llamadas por superficie sobre un contador compartido por identificador; ambos predeterminados 5; 0 cierra el acceso medido en esa superficie mientras deja abierta la emisión de identificadores y la navegación get_chains_list), BLOCKSCOUT_SESSION_TTL_SECONDS (predeterminado 900) y BLOCKSCOUT_SESSION_SWEEP_INTERVAL_SECONDS (con qué frecuencia se limpian las filas de sesión caducadas; predeterminado: una vez por TTL).

Modo Stdio: El modo stdio predeterminado está diseñado para usarse con hosts/clientes MCP (como Claude Desktop, Cursor) y no tiene sentido ejecutarlo directamente con Docker sin un cliente MCP que gestione la comunicación.

Pruebas con Claude Desktop

Use el paquete MCP para probar el servidor con Claude Desktop.

  1. Compile el paquete según las instrucciones en mcpb/README.md.
  2. Abra Claude Desktop.
  3. Haga doble clic para abrir el archivo blockscout-mcp-dev.mcpb e instalar automáticamente el paquete.
  4. Configure la URL del servidor MCP de Blockscout cuando se le solicite (predeterminado: http://127.0.0.1:8000/mcp)

Privacidad y telemetría anónima

Para ayudarnos a mejorar el servidor MCP de Blockscout, las instancias del servidor gestionadas por la comunidad recopilan datos de uso anónimos de forma predeterminada. Esto nos ayuda a entender qué herramientas son más populares y guía nuestros esfuerzos de desarrollo.

Lo que recopilamos:

  • El nombre de la herramienta que se está llamando (por ejemplo, get_block_number).
  • Los parámetros proporcionados a la herramienta (el parámetro session_id se enmascara con un marcador de posición antes de la transmisión).
  • La versión del servidor MCP de Blockscout que se está utilizando.
  • Un hash unidireccional e irreversible (SHA-256) de la clave PRO API disponible para autorizar la solicitud, cuando está presente. Esto es solo una huella derivada: la clave en sí nunca se transmite y no se puede recuperar del hash.

Lo que NO recopilamos:

  • No recopilamos ningún dato personal, direcciones IP (el servidor central usa la IP del remitente para geolocalización a través de Mixpanel y luego la descarta), ni secretos o claves privadas en sí. La clave PRO API en particular nunca se transmite — solo su huella unidireccional e irreversible descrita anteriormente, de la cual no se puede recuperar la clave.

Cómo optar por no participar

Puede desactivar esta función en cualquier momento configurando la siguiente variable de entorno:

export BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true

Licencia

License: Blockscout Software Licence

Este proyecto está licenciado bajo la Licencia de Software de Blockscout. Consulte el archivo LICENSE para conocer los términos completos.