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?

  • Resolver direcciones y tokens — Solicita convertir un nombre ENS a una dirección con get_address_by_ens_name o encuentra direcciones de tokens por símbolo mediante lookup_token_by_symbol.
  • Inspeccionar carteras y contratos — Obtén detalles completos de direcciones, tenencias ERC-20, colecciones NFT y código fuente verificado de contratos usando get_address_info, get_tokens_by_address, nft_tokens_by_address e inspect_contract_code.
  • Consultar actividad en cadena — Recupera transacciones, transferencias de tokens y detalles de bloques para cualquier dirección o cadena con get_transactions_by_address, get_token_transfers_by_address y get_block_info.
  • Leer estado de contratos — Ejecuta funciones de contrato inteligente de solo lectura directamente con read_contract usando un ABI proporcionado, u obtén el ABI en sí mediante get_contract_abi.
  • Explorar cadenas y datos sin procesar — Lista las cadenas compatibles con get_chains_list o llama a cualquier endpoint de la API de Blockscout a través de direct_api_call para consultas avanzadas.

Documentación

Servidor MCP de Blockscout

smithery badge

Blockscout Server MCP server

El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto diseñado para permitir que agentes de IA, IDEs 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 y herramientas de IA (como Claude, Cursor o IDEs) puedan acceder a ellos y analizarlos contextualmente.

Características principales:

  • Acceso contextual a datos de blockchain para herramientas de IA
  • Soporte multi-cadena mediante 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
  • Segmentación inteligente de respuestas con tamaños de página configurables para evitar el desbordamiento del contexto
  • Paginación con cursor opaco mediante 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 ToolResponse estandarizado con respuestas JSON estructuradas e instrucciones de seguimiento
  • Observabilidad mejorada con notificaciones de progreso de 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 desde el repositorio agent-skills. 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 agent-skills 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.

Uso del directorio de conectores de Claude - Recomendado

La forma más fácil de usar el servidor MCP de Blockscout con Claude (Web, Desktop y Code) es a través del Directorio de conectores de Anthropic oficial. Esto proporciona una experiencia de instalación nativa y gestionada con actualizaciones automáticas.

Instalación

Opción 1: Enlace directo

Visita claude.com/connectors/blockscout y haz clic en los enlaces de la sección "Used in" 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

Nota: Los conectores requieren un plan de Claude de pago (Pro, Team, Max o Enterprise).

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 Desktop

Para usar el servidor MCP oficial de Blockscout con tu propia clave de API PRO en Claude Desktop, elige una de las siguientes opciones:

Opción 1: Paquete MCP (MCPB) — Recomendado

Ideal para: Instalación fácil y actualizaciones automáticas.

  1. Descarga la última versión de blockscout-mcp.mcpb desde GitHub releases.
  2. Haz doble clic en el archivo .mcpb para instalarlo en Claude Desktop.
  3. Configura tu clave de API PRO de Blockscout cuando se te solicite.
  4. La extensión se conecta automáticamente al servicio MCP de Blockscout alojado.

Opción 2: Proxy Docker

Nota: Docker es necesario para esta configuración.

Ideal para: Usuarios familiarizados con herramientas de línea de comandos y configuraciones personalizadas.

  1. Abre Claude Desktop y haz clic en Configuración

  2. Navega a la sección "Developer"

  3. Haz clic en "Editar configuración"

  4. Abre el archivo claude_desktop_config.json y configura el servidor:

    {
      "mcpServers": {
        "blockscout": {
          "command": "docker",
          "args": [
            "run",
            "--rm",
            "-i",
            "sparfenyuk/mcp-proxy:latest",
            "--transport",
            "streamablehttp",
            "--headers",
            "Blockscout-MCP-Pro-Api-Key",
            "proapi_your_key_here",
            "--headers",
            "Blockscout-MCP-Intermediary",
            "ClaudeDesktop",
            "https://mcp.blockscout.com/mcp"
          ]
        }
      }
    }
    
  5. Guarda el archivo y reinicia Claude Desktop

Configuración de Claude Code

Pasa tu clave de API PRO a través del encabezado Blockscout-MCP-Pro-Api-Key al agregar 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 servidor MCP en Claude Code, lo que te permitirá acceder y analizar datos de blockchain directamente desde tu entorno de codificación.

Configuración de aplicaciones de ChatGPT

Instala la aplicación de Blockscout desde el marketplace 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 en tu cuenta de ChatGPT.

Configuración de la aplicación Codex

  1. Abre Codex y ve a Configuración > Servidores MCP > Agregar servidor.
  2. Establece Nombre como Blockscout, selecciona la pestaña Streamable HTTP y establece URL como https://mcp.blockscout.com/mcp.
  3. En Encabezados, agrega 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. Genera la entrada del servidor:

    codex mcp add Blockscout --url https://mcp.blockscout.com/mcp
    
  2. Edita ~/.codex/config.toml para agregar el encabezado de la clave de API PRO y habilitar el cliente MCP streamable-HTTP (necesario 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

Agrega el servidor a tu configuración MCP de Cursor — ya sea la .cursor/mcp.json a nivel de proyecto o la ~/.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 obtener instrucciones completas sobre cómo ejecutar pruebas unitarias y 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 a la habilidad blockscout-analysis y la regla de resolución de URI. Llámala una vez por sesión, antes que 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) de 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, incluidos 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, incluidos 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 la transacción 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 solo lectura de un contrato inteligente 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 sin procesar de la API de Blockscout 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 (el valor predeterminado es "Blockscout MCP"). La versión del servidor se agrega 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 en el repositorio ni la incrustes en un binario distribuido con el cliente; cuando se ejecute mediante Docker, pásala en tiempo de ejecución (p. ej., -e BLOCKSCOUT_PRO_API_KEY=...) en lugar de incluirla 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 mediante BLOCKSCOUT_PRO_API_KEY_HEADER (establécelo en una cadena vacía para deshabilitar por completo las claves proporcionadas por el cliente). Esto funciona de la misma manera 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 no hay ninguna, la solicitud falla con el error de no configurado. Una clave de cliente que está presente pero mal formada 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 incorrecta); 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 agrega una nota de aviso 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 mediante BLOCKSCOUT_PRO_API_LOW_CREDITS_THRESHOLD (predeterminado: 5000 créditos; establécelo en 0 para deshabilitar la nota). La nota se activa para cualquier saldo por debajo del umbral, incluidos saldos cero y negativos.

Aviso de requisito de clave de API PRO. BLOCKSCOUT_PRO_API_KEY_REQUIRED_NOTICE contiene un aviso configurado por el operador que el servidor agrega como última entrada del campo notes de las respuestas de herramientas cuyas solicitudes no llevaban la clave de API PRO propia (bien formada) del cliente. Existe para anunciar la migración del servidor público oficial a claves obligatorias proporcionadas por el cliente, por lo que solo se espera que la implementación oficial lo establezca. Cuando la variable no está definida o está vacía (el valor predeterminado), la función está completamente desactivada. Los operadores de la comunidad y autoalojados deben dejarla vacía — en particular en modo stdio, donde configuras BLOCKSCOUT_PRO_API_KEY tú 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 tu 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 puedes 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), puedes habilitar respuestas JSON simples en lugar de flujos SSE:

export BLOCKSCOUT_DEV_JSON_RESPONSE=true
python -m blockscout_mcp_server --http

Nota: Esto desactiva los Eventos Enviados por el Servidor (SSE) y las notificaciones de progreso. Úsalo solo para pruebas locales y depuración.

Túneles con Ngrok (Modo de Desarrollo):

El SDK MCP de Python 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. Inicia un túnel ngrok hacia tu servidor local:

    ngrok http 8000
    
  2. Configura el host y el origen permitidos usando tu 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 configuradas, la protección contra el reenlace de DNS se determina automáticamente por el host de enlace del servidor: habilitada para localhost, deshabilitada para hosts que no sean localhost (por ejemplo, 0.0.0.0). Si tu encabezado Host incluye un puerto no estándar, usa el sufijo comodín :* (por ejemplo, "example.com:*") o especifica el valor exacto de host:puerto.

Para más detalles sobre túneles ngrok con servidores MCP, consulta 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, usa 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).

Construcción de la Imagen Docker Localmente

Inicializa el submódulo de habilidades incluido, hornea sus metadatos de commit en el contexto de construcción de Docker y luego construye 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 el Registro de Contenedores de GitHub

Extrae la imagen preconstruida:

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, usa --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 de API PRO de Blockscout:

Pasa la clave en tiempo de ejecución con -e en lugar de incorporarla en la imagen (consulta Proporcionar la Clave de API PRO 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 una persona que llama sin una clave de API PRO 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éralo, no lo inventes), y requiere modo HTTP y una clave de API PRO del lado del servidor (las llamadas medidas se atienden upstream con ella), además de un volumen persistente para la base de datos de sesiones. Genera el secreto una vez y guárdalo 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: deja BLOCKSCOUT_SESSION_SECRET sin configurar (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 incorpores 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, rota 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 sesiones expiradas; 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

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

  1. Construye el paquete según las instrucciones en mcpb/README.md.
  2. Abre Claude Desktop.
  3. Haz doble clic para abrir el archivo blockscout-mcp-dev.mcpb e instalar automáticamente el paquete.
  4. Configura la URL del Servidor MCP de Blockscout cuando se te 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 ejecutadas 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 de API PRO disponible para autorizar la solicitud, cuando hay una 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í. En particular, la clave de API PRO nunca se transmite — solo su huella unidireccional e irreversible descrita anteriormente, de la cual no se puede recuperar la clave.

Cómo Excluirse

Puedes 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. Consulta el archivo LICENSE para conocer los términos completos.