Hive MCP Server

Fornece inteligência em tempo real sobre criptomoedas e Web3 usando a API Hive Intelligence.

Documentação

Hive Intelligence

Uma única conexão para due diligence de cripto com evidências.

Toda resposta com suporte da Hive traz fontes, atualização e um recibo de execução. O MCP hospedado normaliza evidências de mercado, carteiras, DeFi, segurança, DEX, NFT e rede em uma única conexão pronta para agentes.

MCP License: MIT Docs Cursor setup VS Code setup

Conectar · Ferramentas · Segurança · SDK · CLI · Preços · FAQ · Obter uma chave de API

Experimente agora, sem conta e sem chave. O caminho anônimo do endpoint hospedado responde a 25 chamadas materiais por IP por dia; descoberta, consulta de esquema e validação são sempre gratuitas:

https://mcp.hiveintelligence.xyz/mcp

Configuração guiada · Guias de instalação · Exemplos de prompts


Conectar

A Hive é um servidor MCP hospedado para clientes que suportam Streamable HTTP remoto. Quando a implantação OAuth hospedada é ativada, clientes interativos a descobrem pelo endpoint público e abrem autorização no navegador. Agentes headless podem usar uma chave de API do armazenamento secreto:

https://mcp.hiveintelligence.xyz/mcp

Pré-preenchimentos de configuração, somente URL, sem chave ou segredo incorporado:

Add to Cursor Install in VS Code Cursor setup VS Code setup

Os pré-preenchimentos carregam apenas a URL do endpoint público. As páginas de configuração verificam os metadados de recursos protegidos ao vivo, o cartão do servidor, a versão do release e os perfis de redirecionamento exigidos pelo cliente antes de mostrar uma ação de instalação nativa. Até que essa verificação passe, use o fallback de chave de API de um backend/cliente confiável; nunca coloque uma chave em um link de instalação. Blocos de configuração por cliente estão abaixo.

O que é Hive Intelligence?

Um servidor MCP gerenciado, API REST e CLI que dão aos agentes de IA uma superfície de fluxo de trabalho com evidências sobre dados de mercado de cripto ao vivo, DeFi, carteiras, segurança de tokens, fluxos DEX, NFTs e dados de rede on-chain. Os agentes recebem o provedor, o tempo de recuperação da Hive, o tempo de primeira observação/cache original da Hive, a idade do cache, o estado de fallback, o status de execução e um recibo único para cada execução material, em vez de misturar dados de provedores silenciosamente.

Conecte-se ao seu cliente de IA

O endpoint hospedado é o mesmo em todos os lugares. Após a ativação do OAuth, clientes interativos devem começar com descoberta OAuth somente por URL. A autenticação por chave de API permanece como fallback explícito para headless.

Claude Code

claude mcp add --transport http --scope user hive https://mcp.hiveintelligence.xyz/mcp

Ou instale o pacote completo de plugins (a conexão MCP hospedada mais 16 habilidades de fluxo de trabalho de cripto) do marketplace de plugins deste repositório:

claude plugin marketplace add hive-intel/hive-sdk
claude plugin install hive@hive

Cursor

~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto):

{
  "mcpServers": {
    "hive": {
      "url": "https://mcp.hiveintelligence.xyz/mcp"
    }
  }
}

VS Code (GitHub Copilot Chat)

.vscode/mcp.json (observe o type: "http" obrigatório):

{
  "servers": {
    "hive": {
      "type": "http",
      "url": "https://mcp.hiveintelligence.xyz/mcp"
    }
  }
}

Claude Desktop

O Claude Desktop usa a interface Custom Connectors para MCP remoto. Abra Configurações → Conectores → Adicionar conector personalizado, defina a URL para https://mcp.hiveintelligence.xyz/mcp e, após a ativação do OAuth, conclua a autorização no navegador. Não cole um bloco url remoto em claude_desktop_config.json; esse arquivo é para servidores stdio locais.

Windsurf / Devin Desktop

O Windsurf usa serverUrl (não o url do Cursor) em ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "hive": {
      "serverUrl": "https://mcp.hiveintelligence.xyz/mcp"
    }
  }
}

Gemini CLI

O Gemini CLI exige httpUrl em ~/.gemini/settings.json:

{
  "mcpServers": {
    "hive": {
      "httpUrl": "https://mcp.hiveintelligence.xyz/mcp"
    }
  }
}

Ambas as configurações são somente URL e podem usar OAuth nativo após a ativação do OAuth hospedado. Guias completos por cliente: hiveintelligence.xyz/install.

Fallback headless com chave de API

Para automação que não pode abrir um navegador, mantenha uma chave de API da Hive no armazenamento secreto e envie Authorization: Bearer $HIVE_API_KEY. Nunca incorpore uma chave real em um link de instalação, configuração compartilhada, captura de tela ou repositório.

Stdio local (self-host / desktop / suas próprias chaves de provedor)

Prefere um processo local ou suas próprias chaves upstream? Execute o CLI publicado como um servidor MCP stdio:

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "-p", "hive-intelligence@latest", "hive"],
      "env": {
        "COINGECKO_DEMO_API_KEY": "optional",
        "ALCHEMY_API_KEY": "optional",
        "HELIUS_API_KEY": "optional",
        "MORALIS_API_KEY": "optional"
      }
    }
  }
}

O stdio local não usa um HIVE_API_KEY hospedado; configure apenas as chaves de provedores upstream que você quer que esse processo local chame. Provedores sem chave permanecem disponíveis e provedores sem credenciais permanecem descobríveis com um status de execução missing_key classificado. hive-intelligence é um transporte stdio (um canal JSON-RPC, não um comando interativo). Para uso no terminal, veja o CLI.

Autenticação

  • Nenhuma chave necessária para começar: o caminho anônimo do endpoint hospedado responde a 25 chamadas materiais por IP por dia, e chamadas de descoberta/esquema/validação são sempre gratuitas.
  • Obtenha uma chave em hiveintelligence.xyz/dashboard/keys quando quiser sua própria cota; o plano Free não exige cartão.
  • Autentique o endpoint hospedado com Authorization: Bearer hive_live_... (o alias legado x-api-key também funciona).
  • Uma chave, privilégio mínimo: as chaves são limitadas ao limite de taxa e créditos do seu plano. Gire ou revogue pelo painel; nunca faça commit de uma chave nem a cole em código no lado do cliente.

Desenvolvido por

Onze integrações de provedores upstream mais Open Data Fetch, normalizadas em uma única superfície de ferramentas:

Alchemy · CoinGecko · DeFiLlama · Moralis · GoPlus · Helius · Tenderly · CCXT · Hyperliquid · RWA Perps · Hive Archive · Open Data Fetch
ProvedorCobertura
AlchemyPortfólio EVM, token, NFT, transferência, simulação, gás, dados de rede e Solana DAS
CoinGeckoDados de mercado, preços, OHLCV, exchanges, coleções NFT, redes on-chain, mercados de RWA tokenizados
DeFiLlamaTVL, pools de rendimento, métricas de protocolo, pontes, tesourarias
MoralisCarteira EVM e Solana, token, NFT, DeFi, transferência e análises de mercado
GoPlusSegurança de tokens, detecção de honeypot, risco de contrato, reputação de endereços maliciosos
HeliusRPC Solana, DAS, NFTs comprimidos, Parsed Events, taxas de prioridade
TenderlySimulação EVM, estimativa de gás, traces, decodificação de contratos, assinaturas, mudanças de armazenamento e intervalos de transações
CCXTDados de exchanges centralizadas, order books, derivativos, funding, alavancagem e taxas de empréstimo
HyperliquidSuperfície /info completa: mercados perp/spot, order books, estado do usuário, vaults, staking, DEXs builder HIP-3, mercados de resultados HIP-4
RWA PerpsFan-out sem chave em cinco venues para perps de ativos tokenizados: DEXs builder HIP-3 da Hyperliquid, Ostium, Avantis, Lighter, Extended
Hive ArchiveHistórico de derivativos com suporte Supabase servido pela Hive, sem chave de provedor
Open Data FetchAcesso permitido e com limite de tamanho a APIs públicas de cripto de cauda longa quando nenhuma ferramenta tipada cobre a fonte

Ferramentas e descoberta

O contrato padrão da Hive é uma raiz compacta de oito ferramentas: três ferramentas hero para os principais objetivos, mais um loop de descoberta/execução de cinco ferramentas sobre o catálogo completo.

Ferramenta raizO que faz
get_token_priceHero: preço ao vivo para qualquer token (response_format: conciso ou detalhado)
check_token_safetyHero: veredito de honeypot, rugpull e risco de contrato antes de qualquer assinatura
get_wallet_portfolioHero: saldos de carteira multi-chain e valor de portfólio
search_toolsEncontre o conjunto de ferramentas certo e roteie pelo catálogo completo (grátis)
get_api_endpoint_schemaInspecione parâmetros exatos antes de executar (grátis)
invoke_api_endpointExecute qualquer endpoint de leitura no catálogo
invoke_stateful_endpointMudanças de estado nativas da Hive; exige aprovação explícita do usuário
validate_task_resultVerifique o envelope final e a estrutura do recibo (grátis)

Os agentes começam com resultados search_tools compactos e paginados, carregam um fluxo de trabalho hive://toolsets/{id} exato, inspecionam get_api_endpoint_schema e então chamam invoke_api_endpoint para leituras ou invoke_stateful_endpoint após aprovação explícita para uma mudança de estado nativa da Hive. validate_task_result verifica o envelope final e a estrutura do recibo; exige citações de reivindicação a recibo e cobertura canônica de fases, mas não pode tornar dados de recibo inventados autênticos.

O catálogo de cauda longa permanece descobrível por trás dessa superfície de fluxo de trabalho: 525 ferramentas chamáveis em 10 categorias.

Cada fluxo de trabalho exato publica um orçamento de chamadas materiais padrão e máximo, fases, condição de fallback e condições de parada. Os agentes param quando a decisão solicitada é suportada e chamam um fallback apenas para resolver uma lacuna material, fonte indisponível, preocupação de desatualização ou desacordo.

#CategoriaFerramentasO que contém
1Dados de Mercado e Preço142Preços, OHLCV, capitalizações de mercado, derivativos, taxas de funding, stablecoins, ganhadores/perdedores, tickers de exchanges
2DEX On-Chain e Pool46Pools DEX, liquidez, pares em alta, histórico de swaps, pontes, volumes de agregadores
3Portfólio e Carteira93Saldos, PnL, posições DeFi, histórico de swaps, participações NFT, histórico multi-chain
4Token e Contrato40Metadados de token, holders, principais traders, resolução ENS, rastreamento de tesouraria, transferências
5Protocolo DeFi19TVL, taxas, yield farming, métricas de chain, tesourarias, emissões
6Análise NFT59Dados de coleção, floors, gráficos de mercado, pools NFT, metadados de traits, vendas
7Segurança e Risco48Detecção de honeypot, verificações de rugpull, risco de aprovação, simulação Tenderly, estimativa de gás
8Rede e Infraestrutura33Saúde da chain, blocos, preços de gás, redes suportadas, infraestrutura Solana
9Busca e Descoberta19Busca entre provedores, moedas em alta, categorias, descoberta de tokens

Clientes que querem uma superfície de ferramentas menor e com escopo podem se conectar diretamente a um endpoint de categoria, por exemplo, https://mcp.hiveintelligence.xyz/hive_market_data/mcp (um por categoria). Visão geral do catálogo público: www.hiveintelligence.xyz/tools/live-catalog. Catálogo REST autenticado: https://mcp.hiveintelligence.xyz/api/v1/tools.

Segurança e confiança

Respostas de cripto só são úteis se forem confiáveis. A Hive é construída para isso:

  • Proveniência em cada resposta. Os resultados das ferramentas trazem um recibo emitido pelo servidor com provedor, tempo de recuperação/observação do Hive, idade do cache, estado da fonte, status do runtime, versão do servidor/build e verificações SHA-256 de entrada/resultado. Os digests não são assinaturas nem um serviço de consulta retido. observed_at é o tempo de primeira observação/cache original do Hive, não necessariamente o tempo do evento upstream; cache_age_ms: 0 significa apenas que foi recém-recuperado pelo Hive. source reporta o estado de entrega, enquanto origin_source preserva se os dados em cache vieram originalmente do tier ao vivo ou de fallback. Use timestamps, blocos, slots, transações ou fechamentos de candle do provedor para recência da fonte e marque como desconhecido quando ausente. O Hive nunca mistura dados de provedores silenciosamente: dados de fallback, cache ou degradados são rotulados como tal.
  • Ponto no tempo, não deriva. As ferramentas de séries temporais aceitam at / block_number para que agentes respondam a perguntas históricas sem recorrer silenciosamente ao "mais recente".
  • Ferramentas com segurança em primeiro lugar. get_token_security, detect_rugpull, risco de aprovação e simulação de transações Tenderly retornam flags de risco estruturadas para que um agente possa verificar antes de o usuário assinar.
  • Menor privilégio e conscientização sobre injeção de prompt. Use uma chave com escopo por ambiente e rotacione pelo dashboard. Como em qualquer agente que usa ferramentas, trate texto on-chain (nomes de tokens, memos) como entrada não confiável. O Hive retorna campos estruturados em vez de instruções de forma livre para reduzir a superfície de injeção.
  • Sem chaves no lado do cliente. Mantenha sua chave Hive no lado do servidor; UIs de navegador devem chamar seu próprio backend, que usa a chave (veja as sessões de assunto B2B do SDK).

Exemplos de prompts

Depois que o Hive estiver conectado, pergunte em português simples. Cada prompt mapeia para uma chamada de ferramenta real que você não precisa escrever:

What's the price of BTC, ETH, and SOL right now in USD?
List the top 20 yield pools above 10% APY on Ethereum.
Show me the portfolio of vitalik.eth across all chains.
Is this token a honeypot? 0x...   ·   Run a rugpull check on $PEPE.
What are the current funding rates for BTC perps across exchanges?
What is the funding on the tokenized TSLA perp across the RWA venues right now?
Simulate this transaction before I sign it: <tx hash or calldata>

Mais guias de fluxo de trabalho: hiveintelligence.xyz/use-cases.

SDK TypeScript: hive-mcp-client

Chame o Hive do seu próprio agente ou backend sem configurar MCP manualmente. O cliente tipado está disponível no npm e em client/:

npm install hive-mcp-client
import { createHiveMcpClient, invokeHiveEndpoint } from "hive-mcp-client";

const hive = await createHiveMcpClient({
  apiKey: process.env.HIVE_API_KEY,
  clientName: "my-app",
});

const result = await invokeHiveEndpoint(hive, "get_price", {
  ids: "bitcoin",
  vs_currencies: "usd",
});
console.log(result.json ?? result.text);
await hive.close();

invokeHiveEndpoint é intencionalmente somente leitura e já retorna um resultado normalizado. Ele rejeita endpoints conhecidos de mudança de estado do Hive. Depois que seu aplicativo mostrar o efeito exato e receber aprovação explícita do usuário, chame o invokeHiveStatefulEndpoint com nome separado; nunca derive aprovação de saída de modelo ou argumentos de ferramenta:

import { invokeHiveStatefulEndpoint } from "hive-mcp-client";

if (!(await approvalUi.confirm({ endpointName, args }))) {
  throw new Error("User declined the Hive state change");
}

const saved = await invokeHiveStatefulEndpoint(hive, endpointName, args);

Use normalizeHiveToolResult apenas quando chamar o método de nível inferior client.callTool() diretamente.

Inclui adaptadores para Vercel AI SDK e LangChain, além de sessões de assunto B2B para backends multi-tenant. Ferramentas stateful do LangChain são desabilitadas, a menos que o aplicativo forneça approveStatefulCall({ endpointName, args }); o callback deve retornar a aprovação explícita do usuário, e invocações stateful materiais nunca são armazenadas em cache pelo adaptador. API completa: client/README.md.

Habilidades do agente

Agent skills instaláveis ensinam Claude Code, Cursor, Codex e outros agentes o fluxo de trabalho do Hive: configuração do MCP, descoberta de ferramentas e pesquisa de cripto ao vivo:

npx skills add hive-intel/hive-skills

Pacote de plugin para Claude Code, OpenAI / Codex e Cursor

A raiz deste repositório também é um pacote de plugin pronto para distribuição. Ele combina peças públicas e revisáveis:

  • .claude-plugin/: plugin Claude Code e manifestos de marketplace sobre a mesma conexão MCP e habilidades de fluxo de trabalho (claude plugin marketplace add hive-intel/hive-sdk).
  • .codex-plugin/plugin.json: metadados de produto e interface, prompts iniciais e declarações de componentes.
  • .cursor-plugin/plugin.json: o manifesto nativo do Cursor sobre a mesma conexão MCP e habilidades de fluxo de trabalho.
  • .mcp.json: a conexão Hive hospedada somente por URL. Ela não contém chave de API, token, cabeçalho ou placeholder de credencial.
  • skills/: fluxos de trabalho de configuração, descoberta e pesquisa de cripto incluídos que ensinam o agente a inspecionar schemas, permanecer dentro dos orçamentos de chamadas do fluxo de trabalho, preservar proveniência e exigir aprovação explícita antes de uma mudança de estado nativa do Hive.
  • marketplace-review.json: texto de listagem vinculado ao release, prompts iniciais e exatamente os cinco casos de revisão positivos e três negativos. É um fixture público de preparação, não um manifesto Cursor ou OpenAI; credenciais de revisores, desafios de domínio, escolhas de disponibilidade e atestados legais permanecem somente no portal.

Uma revisão de catálogo Codex ou plugin Cursor pode ingerir a raiz do repositório para que a conexão MCP remota e suas orientações de fluxo de trabalho cheguem juntas. Este pacote não afirma que o Hive já está listado em qualquer marketplace público; use o guia de instalação do Hive atual até que uma listagem de catálogo esteja ativa.

CLI

O CLI hive é um cliente de terminal leve sobre a mesma API. Defina HIVE_API_KEY (ou execute hive auth login uma vez):

hive market price --ids bitcoin,ethereum,solana --vs usd   # prices
hive defi tvl --protocol aave                              # DeFi TVL
hive security scan --token 0x...                           # token security
hive portfolio balance --address 0x...                     # wallet portfolio
hive tools search "funding rate"                           # search the 525-tool catalog
hive tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}'

Flags globais incluem --json, --pretty, --jq <expr>, --csv, --fields, --timeout, -q/--quiet. Autenticação: hive auth login | whoami | profiles | switch. Diagnóstico: hive doctor, hive status. Completar shell: hive completion <bash|zsh|fish> --install. Aliases: hive alias set btc 'market price --ids bitcoin --vs usd'. Referência completa: hiveintelligence.xyz/cli.

Configuração

VariávelDescrição
HIVE_API_KEYObrigatório. Chave de API, ou execute hive auth login
HIVE_API_URLURL base personalizada (padrão: https://mcp.hiveintelligence.xyz)
API_EXECUTE_ENDPOINTSubstituir endpoint de execução (avançado)

Preços

PlanoCréditos mensaisLimite de taxaChaves de APIPreço
Grátis10.000100 req/min5Grátis
Starter100.000300 req/min5$49/mês
Pro500.000500 req/min10$149/mês
EnterprisePersonalizadoPersonalizado req/minPersonalizadoPersonalizado

Um crédito = uma execução de endpoint material, independentemente do provedor ou tamanho da resposta. search_tools, get_api_endpoint_schema, validate_task_result, MCP tools/list, leituras de recursos MCP e GET /api/v1/tools autenticados são gratuitos. Preços completos: hiveintelligence.xyz/pricing · legível por máquina: hiveintelligence.xyz/pricing.md.

Por que Hive em vez de um MCP de provedor único?

HiveCoinGecko MCPMoralis MCPDeFiLlama MCPGoPlus only
Grupos de provedores121111
Categorias92311
Total de ferramentas525~50~60~15~20
Dados de mercado✓✓parcial––
TVL DeFi + rendimentos✓––✓–
Portfólio de carteira✓–✓––
Segurança pré-assinatura✓–––✓
Análise de pools DEX✓–parcial––
Perps de RWA tokenizados✓––––
Profundidade Solana (DAS)✓––––
Gerenciado (sem operações)✓✓parcialvariavaria

MCPs de provedor único vencem em profundidade de nicho. O Hive vence quando o agente precisa de contexto cripto amplo em uma única solicitação: preços + DeFi + carteira + segurança + DEX em uma única conversa, sem que ninguém precise descobrir qual ferramenta vive em qual provedor.

FAQ

Quanto custa uma chave de API? Nada para começar: o lane anônimo não precisa de chave alguma (25 chamadas materiais por IP por dia), e o plano Grátis adiciona 10.000 créditos mensais sem exigir cartão. Planos pagos começam em $49/mês (Starter, 100K créditos); Pro é $149/mês para 500K. Obtenha uma chave.

Hospedado vs stdio local: qual devo usar? Hospedado (https://mcp.hiveintelligence.xyz/mcp) é recomendado para a maioria das integrações: sem servidor local, o Hive gerencia autenticação, limites de taxa e infraestrutura de provedores. Use stdio local para configurações de desktop, auto-hospedagem ou suas próprias chaves de provedor upstream.

Quais clientes de IA suportam MCP? Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot Chat), Codex CLI, Gemini CLI, OpenAI Responses API e clientes que suportam Streamable HTTP MCP. Conectores OAuth nativos ficam disponíveis após a ativação do OAuth hospedado; cabeçalhos de chave de API permanecem como fallback headless confiável.

Quais chains são suportadas? EVM (Ethereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche e 90+ outras), Solana com cobertura completa Helius DAS incluindo NFTs comprimidos, Bitcoin e outras dependendo da combinação de provedores por categoria.

O código-fonte é aberto? O SDK do cliente tipado (client/) e as habilidades de agente do Hive são licenciados sob MIT e open source. O servidor MCP do Hive que alimenta mcp.hiveintelligence.xyz é um serviço gerenciado e proprietário.

Como o Hive mantém respostas confiáveis? Todo resultado material carrega atribuição de provedor, estado de fonte/cache, status de runtime e um recibo emitido pelo servidor. O Hive separa seu próprio tempo de observação da recência da fonte do provedor, nunca mistura dados de provedores silenciosamente e expõe parâmetros de ponto no tempo onde os provedores os suportam. Veja Segurança e confiança.

Documentação

Suporte

Licença

MIT © Hive Intelligence