Blockscout
oficialAcesse dados de blockchain como saldos, tokens e NFTs das APIs do Blockscout. Suporta múltiplas cadeias e notificações de progresso.
O que você pode fazer com Blockscout MCP?
- Resolver endereços e tokens — Peça ao
get_address_by_ens_namepara converter um nome ENS em um endereço, oulookup_token_by_symbolpara encontrar tokens por símbolo em várias chains. - Inspecionar contratos e código — Use
get_contract_abieinspect_contract_codepara recuperar a ABI de um smart contract ou os arquivos de código-fonte verificados. - Analisar atividade de carteira — Consulte
get_transactions_by_address,get_token_transfers_by_addressenft_tokens_by_addresspara revisar o histórico de transações de um endereço, transferências ERC-20 ou participações em NFTs. - Explorar blocos e transações — Obtenha detalhes via
get_block_infoeget_transaction_info, incluindo entradas decodificadas, gás usado e transferências de tokens. - Ler estado do contrato — Chame
read_contractpara executar funções somente leitura em um smart contract em um bloco especificado. - Acessar dados brutos da chain — Use
direct_api_callpara consultas avançadas ou específicas da chain nos endpoints do Blockscout.
Servidor MCP hospedado
npx add-mcp 'https://mcp.blockscout.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Servidor MCP Blockscout
O Model Context Protocol (MCP) é um protocolo aberto projetado para permitir que agentes de IA, IDEs e ferramentas de automação consumam, consultem e analisem dados estruturados por meio de APIs sensíveis ao contexto.
Este servidor encapsula as APIs do Blockscout e expõe dados de blockchain—saldos, tokens, NFTs, metadados de contratos—via MCP, para que agentes de IA e ferramentas (como Claude, Cursor ou IDEs) possam acessá-los e analisá-los contextualmente.
Principais recursos:
- Acesso contextual a dados de blockchain para ferramentas de IA
- Suporte a múltiplas cadeias via configuração da API PRO do Blockscout com enriquecimento de metadados Chainscout
- API REST versionada: fornece uma interface padrão e amigável à web para todas as ferramentas MCP. Consulte API.md para documentação completa.
- Instruções personalizadas para o host MCP usar o servidor
- Otimização inteligente de contexto para economizar tokens de LLM, preservando a acessibilidade dos dados
- Divisão inteligente de respostas com tamanhos de página configuráveis para evitar estouro de contexto
- Paginação por cursor opaco usando strings codificadas em Base64URL em vez de parâmetros complexos
- Truncamento automático de grandes campos de dados com indicadores claros e orientação de acesso
- Modelo padronizado de resposta ToolResponse com respostas JSON estruturadas e instruções de acompanhamento
- Observabilidade aprimorada com notificações de progresso MCP e atualizações periódicas para operações de longa duração
Análise Aprimorada com Habilidades de Agente
Para uma análise de blockchain mais poderosa e eficiente, instale a habilidade Blockscout Analysis do repositório agent-skills. Essa habilidade fornece aos agentes de IA orientação estruturada para estratégias de execução, tratamento de respostas, práticas recomendadas de segurança e orquestração de fluxos de trabalho.
Saiba mais: Consulte o README do agent-skills para conhecer todos os recursos e instruções de instalação.
Configurando Clientes MCP
Chave da API PRO do Blockscout
Configurar o servidor MCP do Blockscout com um agente de IA requer uma chave da API PRO do Blockscout. A maioria das ferramentas de dados roteia suas solicitações pelo gateway autenticado da API PRO do Blockscout; portanto, sem uma chave válida, essas ferramentas falham rapidamente antes de fazer qualquer solicitação upstream.
Para obter uma chave, registre-se no Portal do Desenvolvedor Blockscout (o nível gratuito não exige cartão de crédito) e gere uma chave de API; as chaves têm o prefixo proapi_. Em seguida, forneça-a ao configurar seu cliente, conforme mostrado nas seções abaixo.
Configuração no Claude (Web, Desktop, Cowork) - Recomendado
A maneira mais fácil de usar o servidor MCP do Blockscout com o Claude é o servidor hospedado oficial: uma experiência de instalação nativa e gerenciada, com atualizações automáticas e sem necessidade de executar nada você mesmo. Adicione-o como um Conector Personalizado com sua própria chave da API PRO. O Claude envia a chave em cada solicitação em um cabeçalho x-api-key, que o servidor aceita como um alias para seu cabeçalho Blockscout-MCP-Pro-Api-Key.
- Abra o Claude e vá para Personalizar > Conectores. Nos planos Team e Enterprise, um proprietário da organização faz isso em Configurações da organização > Conectores.
- Clique em Adicionar conector personalizado. Defina o nome como
Blockscoute a URL comohttps://mcp.blockscout.com/mcpe continue. - Deixe Autenticação como
None(o Claude detecta isso). Um aviso de que o conector não tem credenciais é esperado: a chave é fornecida na próxima etapa. - Abra Cabeçalhos de solicitação, selecione
x-api-keyna lista e cole sua chave da API PRO como valor. Escolha exatamente esse nome; o servidor não lê os outros nomes de aparência semelhante na lista. - Clique em Adicionar.
Observação: A seção Cabeçalhos de solicitação está em versão beta e ainda não está disponível para todas as organizações. Se a sua caixa de diálogo não a exibir, use o Diretório de Conectores abaixo.
Observação: Nos planos Team e Enterprise, a chave é inserida uma vez pelo proprietário e compartilhada por toda a organização. As configurações de autenticação não podem ser editadas após a adição de um conector: para alterar a chave, remova o conector e adicione-o novamente.
Usando o Diretório de Conectores do Claude
Se a caixa de diálogo do Conector Personalizado não tiver a seção Cabeçalhos de solicitação, instale o conector Blockscout do Diretório de Conectores Anthropic oficial. Ele se conecta ao mesmo servidor hospedado, mas usa uma chave de acesso compartilhada.
Instalação
Opção 1: Link Direto
Visite claude.com/connectors/blockscout e clique nos links da seção "Usado em" para instalar o conector Blockscout.
Opção 2: Via Configurações
- Abra o Claude (aplicativo Web ou Desktop)
- Vá para Configurações > Conectores > Procurar conectores
- Pesquise por "Blockscout"
- Clique em "Conectar" para instalar
Limitações: Devido ao uso de uma chave de acesso compartilhada, pode haver restrições no acesso e nos recursos do conector.
Configuração no Claude Code
Passe sua chave da API PRO pelo cabeçalho Blockscout-MCP-Pro-Api-Key ao adicionar o servidor:
claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp \
--header "Blockscout-MCP-Pro-Api-Key: proapi_your_key_here"
Após executar este comando, o Blockscout estará disponível como um servidor MCP no Claude Code, permitindo que você acesse e analise dados de blockchain diretamente do seu ambiente de codificação.
Configuração nos Aplicativos ChatGPT
Instale o aplicativo Blockscout no marketplace de Aplicativos ChatGPT:
- Abra a página do aplicativo Blockscout (ou pesquise por "Blockscout" no diretório de Aplicativos ChatGPT).
- Clique em "Conectar" para habilitar o aplicativo para sua conta do ChatGPT.
Configuração no Aplicativo Codex
- Abra o Codex e vá para Configurações > Servidores MCP > Adicionar servidor.
- Defina Nome como
Blockscout, selecione a guia HTTP Streamable e defina URL comohttps://mcp.blockscout.com/mcp. - Em Cabeçalhos, adicione um cabeçalho com a chave
Blockscout-MCP-Pro-Api-Keye o valorproapi_your_key_here. - Salve e reinicie o aplicativo Codex.
Configuração no Codex CLI
O Codex CLI não pode anexar um cabeçalho personalizado pela linha de comando, então configure-o em duas etapas:
-
Estruture a entrada do servidor:
codex mcp add Blockscout --url https://mcp.blockscout.com/mcp -
Edite
~/.codex/config.tomlpara adicionar o cabeçalho da chave da API PRO e habilitar o cliente MCP HTTP streamable (necessário para que servidores MCP remotos se conectem). A configuração resultante deve ficar assim:[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" }
Configuração no Cursor
Adicione o servidor à sua configuração MCP do Cursor — seja o .cursor/mcp.json no nível do projeto ou o ~/.cursor/mcp.json global — fornecendo sua chave da API PRO pelo cabeçalho 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"
}
}
}
}
Configuração de Desenvolvimento Local (Para Desenvolvedores)
Se você quiser executar o servidor localmente para fins de desenvolvimento:
{
"mcpServers": {
"blockscout": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"ghcr.io/blockscout/mcp-server:latest"
]
}
}
}
Detalhes técnicos
Consulte SPEC.md para obter os detalhes técnicos.
Estrutura do Repositório
Consulte AGENTS.md para obter a estrutura do repositório.
Testes
Consulte TESTING.md para obter instruções abrangentes sobre como executar testes unitários e de integração.
Descrições das Ferramentas
__unlock_blockchain_analysis__()- Inicializa uma sessão MCP do Blockscout: retorna dados de referência do servidor, o ponteiro da habilidadeblockscout-analysise a regra de resolução de URI. Chame-a uma vez por sessão, antes de qualquer outra ferramenta.get_chains_list(query=None)- Retorna uma lista de cadeias suportadas, com filtragem opcional por nome, ID da cadeia, moeda nativa ou ecossistema.get_address_by_ens_name(name)- Converte um nome de domínio ENS em seu endereço Ethereum correspondente.lookup_token_by_symbol(chain_id, symbol)- Pesquisa endereços de tokens por símbolo ou nome, retornando múltiplas correspondências potenciais.get_contract_abi(chain_id, address)- Recupera a ABI (Interface Binária de Aplicação) de um contrato inteligente.inspect_contract_code(chain_id, address, file_name=None)- Permite obter os arquivos de origem de contratos verificados.get_address_info(chain_id, address)- Obtém informações abrangentes sobre um endereço, incluindo saldo, associação ENS, status do contrato, detalhes de tokens e tags públicas.get_tokens_by_address(chain_id, address, cursor=None)- Retorna as participações detalhadas em tokens ERC20 de um endereço, com metadados enriquecidos e dados de mercado.get_block_number(chain_id, [datetime])- Recupera o número do bloco e o timestamp para uma data/hora específica ou o bloco mais recente.get_transactions_by_address(chain_id, address, age_from, age_to, methods, cursor=None)- Obtém transações de um endereço em um intervalo de tempo específico, com filtragem opcional por método.get_token_transfers_by_address(chain_id, address, age_from, age_to, token, cursor=None)- Retorna transferências de tokens ERC-20 para um endereço em um intervalo de tempo específico.nft_tokens_by_address(chain_id, address, cursor=None)- Recupera tokens NFT pertencentes a um endereço, agrupados por coleção.get_block_info(chain_id, number_or_hash, include_transactions=False)- Retorna informações do bloco, incluindo timestamp, gás usado, taxas queimadas e contagem de transações. Opcionalmente, pode incluir uma lista de hashes de transações.get_transaction_info(chain_id, hash, include_raw_input=False)- Obtém informações abrangentes de transação com parâmetros de entrada decodificados e transferências de tokens detalhadas.read_contract(chain_id, address, abi, function_name, args='[]', block='latest')- Executa uma função de contrato inteligente somente leitura e retorna seu resultado. O argumentoabié um objeto JSON que descreve a assinatura da função específica.direct_api_call(chain_id, endpoint_path, query_params=None, cursor=None, method='GET', json_body=None)- Chama um endpoint bruto da API Blockscout para dados avançados ou específicos da cadeia. Suporta solicitações GET (padrão) e POST com corpo JSON.
Exemplos de Prompts 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?
Desenvolvimento e Implantação
Instalação Local
Clone o repositório e instale as dependências:
git clone https://github.com/blockscout/mcp-server.git
cd mcp-server
uv pip install -e . # or `pip install -e .`
Para personalizar a parte inicial do cabeçalho User-Agent usado para solicitações RPC,
defina a variável de ambiente BLOCKSCOUT_MCP_USER_AGENT (o padrão é
"Blockscout MCP"). A versão do servidor é anexada automaticamente.
Fornecendo a Chave da API PRO ao Servidor
Quando você executa o servidor, forneça a chave da API PRO do Blockscout por meio da variável de ambiente BLOCKSCOUT_PRO_API_KEY — exportada no seu shell ou colocada em um arquivo .env ignorado pelo git na raiz do projeto. Isso habilita todo o acesso a dados, enriquecimento de tags públicas e leituras de contratos. Nunca confirme a chave nem a incorpore em um binário distribuído ao cliente; ao executar via Docker, passe-a em tempo de execução (por exemplo, -e BLOCKSCOUT_PRO_API_KEY=...) em vez de gravá-la na imagem.
export BLOCKSCOUT_PRO_API_KEY=proapi_your_key_here
Chaves fornecidas pelo cliente (transportes HTTP). Quando o servidor é executado em modo HTTP, um cliente pode fornecer sua própria chave da API PRO em um cabeçalho de solicitação — por padrão Blockscout-MCP-Pro-Api-Key, configurável via BLOCKSCOUT_PRO_API_KEY_HEADER (defina-a como uma string vazia para desabilitar completamente as chaves fornecidas pelo cliente). O servidor também lê a chave de um cabeçalho x-api-key, para clientes cujos nomes de cabeçalho são restritos a uma lista fixa (por exemplo, Conectores Personalizados do Claude). O cabeçalho configurado tem precedência quando ambos estão presentes; x-api-key é consultado somente quando o cabeçalho configurado está ausente ou em branco, e desabilitar as chaves fornecidas pelo cliente também o desabilita. Isso funciona da mesma forma para ambos os transportes HTTP — chamadas de ferramentas MCP sobre HTTP e a API REST. Uma chave fornecida pelo cliente tem precedência sobre BLOCKSCOUT_PRO_API_KEY para essa solicitação; se o cliente não enviar chave, o servidor volta a usar sua própria chave configurada; se nenhuma estiver presente, a solicitação falha com o erro de não configurado. Uma chave de cliente presente, mas malformada, faz qualquer solicitação que precise da API PRO falhar sem fallback (o servidor nunca usa silenciosamente sua própria chave no lugar de uma chave de cliente inválida); ferramentas que não usam a API PRO não são afetadas. Isso torna possível executar um servidor HTTP compartilhado onde cada cliente se autentica com sua própria chave.
Aviso de crédito baixo. O acesso à API PRO é medido em créditos. Quando o saldo restante relatado pela API cair abaixo de um limite configurável, cada ferramenta de dados anexa uma nota de aviso à sua resposta, solicitando que os operadores façam uma recarga para que o acesso à API PRO permaneça pronto para uso contínuo em alto volume. O limite é definido via BLOCKSCOUT_PRO_API_LOW_CREDITS_THRESHOLD (padrão 5000 créditos; defina como 0 para desabilitar a nota). A nota é acionada para qualquer saldo abaixo do limite, incluindo saldos zero e negativos.
Aviso sobre o requisito de chave PRO da API. BLOCKSCOUT_PRO_API_KEY_REQUIRED_NOTICE contém um aviso configurado pelo operador que o servidor anexa como a última entrada do campo notes das respostas de ferramentas cujas solicitações não incluíam a própria chave PRO da API (bem formada) do cliente. Ele existe para anunciar a migração do servidor público oficial para chaves fornecidas pelo cliente, portanto, apenas a implantação oficial deve defini-lo. Quando a variável não está definida ou está vazia (o padrão), o recurso está completamente desativado. Operadores comunitários e auto-hospedados devem deixá-lo vazio — especialmente no modo stdio, onde você configura o BLOCKSCOUT_PRO_API_KEY você mesmo e nenhum cabeçalho de solicitação pode conter uma chave de cliente, o aviso apenas repetiria uma mensagem de migração que não se aplica à sua implantação.
Executando o Servidor
O servidor é executado no modo stdio por padrão:
python -m blockscout_mcp_server
Modo HTTP (somente MCP):
Para executar o servidor no modo HTTP Streamable (sem estado, respostas SSE por padrão):
python -m blockscout_mcp_server --http
Você também pode especificar o host e a porta para o servidor HTTP:
python -m blockscout_mcp_server --http --http-host 0.0.0.0 --http-port 8080
Modo de Desenvolvimento (Respostas JSON Simples):
Para desenvolvimento e testes com clientes HTTP simples (curl, Insomnia), você pode habilitar respostas JSON simples em vez de fluxos SSE:
export BLOCKSCOUT_DEV_JSON_RESPONSE=true
python -m blockscout_mcp_server --http
Nota: Isso desativa Server-Sent Events (SSE) e notificações de progresso. Use apenas para testes e depuração locais.
Tunelamento com Ngrok (Modo de Desenvolvimento):
O SDK Python do MCP aplica proteção contra rebinding de DNS, que bloqueia solicitações de túneis ngrok por padrão. Para habilitar o tunelamento para desenvolvimento e testes:
-
Inicie um túnel ngrok para o seu servidor local:
ngrok http 8000 -
Configure o host e a origem permitidos usando sua URL 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: Essas configurações são principalmente para uso em desenvolvimento. Quando essas variáveis não estão definidas, a proteção contra rebinding de DNS é determinada automaticamente pelo host de vinculação do servidor: habilitada para localhost, desabilitada para não-localhost (por exemplo, 0.0.0.0). Se o seu cabeçalho Host incluir uma porta não padrão, use o sufixo curinga :* (por exemplo, "example.com:*") ou especifique o valor exato de host:porta.
Para mais detalhes sobre tunelamento ngrok com servidores MCP, consulte a https://github.com/openai/openai-apps-sdk-examples/blob/main/README.md#testing-in-chatgpt.
Modo HTTP com API REST:
Para habilitar a API REST versionada junto com o endpoint MCP, use o sinalizador --rest (que requer --http).
python -m blockscout_mcp_server --http --rest
Com host e porta personalizados:
python -m blockscout_mcp_server --http --rest --http-host 0.0.0.0 --http-port 8080
Opções de CLI:
--http: Habilita o modo HTTP Streamable.--http-host TEXT: Host para vincular o servidor HTTP (padrão:127.0.0.1).--http-port INTEGER: Porta para o servidor HTTP (padrão:8000).--rest: Habilita a API REST (requer--http).
Construindo a Imagem Docker Localmente
Inicialize o submódulo de skill incluído, incorpore seus metadados de commit no contexto de build do Docker e, em seguida, construa a imagem:
git submodule update --init --recursive agent-skills
python scripts/bake_skill_metadata.py
docker build -t ghcr.io/blockscout/mcp-server:latest .
Baixando do GitHub Container Registry
Baixe a imagem pré-construída:
docker pull ghcr.io/blockscout/mcp-server:latest
Executando com Docker
Modo HTTP (somente MCP):
Para executar o contêiner Docker no modo HTTP com mapeamento de porta:
docker run --rm -p 8000:8000 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --http-host 0.0.0.0
Com porta personalizada:
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 com API REST:
Para executar com a 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: Ao executar no modo HTTP com Docker, use --http-host 0.0.0.0 para vincular a todas as interfaces, para que o servidor seja acessível de fora do contêiner.
Com uma Chave PRO da API Blockscout:
Passe a chave em tempo de execução com -e em vez de incorporá-la na imagem (consulte Fornecendo a Chave PRO da API ao 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
Com medição de sessão habilitada (opcional):
A medição de sessão limita quantas chamadas de ferramenta um chamador sem uma chave PRO da API fornecida pelo cliente pode fazer por identificador de sessão emitido por __unlock_blockchain_analysis__. Está desativada por padrão. Habilitá-la significa definir um segredo de assinatura (pelo menos 32 bytes — gere-o, não o invente), e requer modo HTTP e uma chave PRO da API no lado do servidor (chamadas medidas são atendidas upstream com ela), além de um volume persistente para o banco de dados de sessão. Gere o segredo uma vez e armazene-o de forma durável (um gerenciador de segredos ou configuração de ambiente persistente); cada reinicialização e reimplantação deve passar o mesmo valor armazenado:
# 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
A maioria das implantações não precisa de nada disso: deixe BLOCKSCOUT_SESSION_SECRET não definido (o padrão) e nenhum volume é necessário. Perder o volume ou rotacionar o segredo invalida identificadores de sessão ativos por design; a exposição é limitada pelo TTL configurado. Regenerar o segredo inline a cada docker run é a forma acidental dessa rotação — ela apaga todos os identificadores ativos a cada reinicialização, mesmo que o volume do banco de dados tenha sobrevivido, então nunca incorpore o comando de geração no comando de início. Restaurar uma cópia mais antiga do banco de dados revive os orçamentos que ele registrou — após uma restauração histórica, rotacione o segredo, a menos que isso seja intencional. Ajustes opcionais: BLOCKSCOUT_SESSION_MCP_MAX_CALLS e BLOCKSCOUT_SESSION_REST_MAX_CALLS (limites de chamadas por superfície sobre um contador compartilhado por identificador; ambos padrão 5; 0 fecha o acesso medido nessa superfície enquanto deixa a emissão de identificadores e a navegação get_chains_list abertas), BLOCKSCOUT_SESSION_TTL_SECONDS (padrão 900) e BLOCKSCOUT_SESSION_SWEEP_INTERVAL_SECONDS (com que frequência as linhas de sessão expiradas são limpas; padrão: uma vez por TTL).
Modo Stdio: O modo stdio padrão é projetado para uso com hosts/clientes MCP (como Claude Desktop, Cursor) e não faz sentido executá-lo diretamente com Docker sem um cliente MCP gerenciando a comunicação.
Testando com Claude Desktop
Use o pacote MCP para testar o servidor com Claude Desktop.
- Construa o pacote conforme as instruções em mcpb/README.md.
- Abra o Claude Desktop.
- Clique duas vezes para abrir o arquivo
blockscout-mcp-dev.mcpbpara instalar automaticamente o pacote. - Configure a URL do Servidor MCP Blockscout quando solicitado (padrão:
http://127.0.0.1:8000/mcp)
Privacidade e Telemetria Anônima
Para nos ajudar a melhorar o Servidor MCP Blockscout, instâncias da comunidade do servidor coletam dados de uso anônimos por padrão. Isso nos ajuda a entender quais ferramentas são mais populares e orienta nossos esforços de desenvolvimento.
O que coletamos:
- O nome da ferramenta sendo chamada (por exemplo,
get_block_number). - Os parâmetros fornecidos à ferramenta (o parâmetro
session_idé mascarado como um espaço reservado antes da transmissão). - A versão do Servidor MCP Blockscout em uso.
- Um hash unidirecional e não reversível (SHA-256) da chave PRO da API disponível para autorizar a solicitação, quando presente. Esta é apenas uma impressão digital derivada — a chave em si nunca é transmitida e não pode ser recuperada do hash.
O que NÃO coletamos:
- Não coletamos nenhum dado pessoal, endereços IP (o servidor central usa o IP do remetente para geolocalização via Mixpanel e depois o descarta), nem segredos e chaves privadas em si. A chave PRO da API em particular nunca é transmitida — apenas sua impressão digital unidirecional e não reversível descrita acima, da qual a chave não pode ser recuperada.
Como Optar por Não Participar
Você pode desativar este recurso a qualquer momento definindo a seguinte variável de ambiente:
export BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true
Licença
Este projeto é licenciado sob a Licença de Software Blockscout. Consulte o arquivo LICENSE para os termos completos.