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.
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/mcpConfiguraçã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:
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 legadox-api-keytambé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
| Provedor | Cobertura |
|---|---|
| Alchemy | Portfólio EVM, token, NFT, transferência, simulação, gás, dados de rede e Solana DAS |
| CoinGecko | Dados de mercado, preços, OHLCV, exchanges, coleções NFT, redes on-chain, mercados de RWA tokenizados |
| DeFiLlama | TVL, pools de rendimento, métricas de protocolo, pontes, tesourarias |
| Moralis | Carteira EVM e Solana, token, NFT, DeFi, transferência e análises de mercado |
| GoPlus | Segurança de tokens, detecção de honeypot, risco de contrato, reputação de endereços maliciosos |
| Helius | RPC Solana, DAS, NFTs comprimidos, Parsed Events, taxas de prioridade |
| Tenderly | Simulação EVM, estimativa de gás, traces, decodificação de contratos, assinaturas, mudanças de armazenamento e intervalos de transações |
| CCXT | Dados de exchanges centralizadas, order books, derivativos, funding, alavancagem e taxas de empréstimo |
| Hyperliquid | Superfície /info completa: mercados perp/spot, order books, estado do usuário, vaults, staking, DEXs builder HIP-3, mercados de resultados HIP-4 |
| RWA Perps | Fan-out sem chave em cinco venues para perps de ativos tokenizados: DEXs builder HIP-3 da Hyperliquid, Ostium, Avantis, Lighter, Extended |
| Hive Archive | Histórico de derivativos com suporte Supabase servido pela Hive, sem chave de provedor |
| Open Data Fetch | Acesso 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 raiz | O que faz |
|---|---|
get_token_price | Hero: preço ao vivo para qualquer token (response_format: conciso ou detalhado) |
check_token_safety | Hero: veredito de honeypot, rugpull e risco de contrato antes de qualquer assinatura |
get_wallet_portfolio | Hero: saldos de carteira multi-chain e valor de portfólio |
search_tools | Encontre o conjunto de ferramentas certo e roteie pelo catálogo completo (grátis) |
get_api_endpoint_schema | Inspecione parâmetros exatos antes de executar (grátis) |
invoke_api_endpoint | Execute qualquer endpoint de leitura no catálogo |
invoke_stateful_endpoint | Mudanças de estado nativas da Hive; exige aprovação explícita do usuário |
validate_task_result | Verifique 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.
| # | Categoria | Ferramentas | O que contém |
|---|---|---|---|
| 1 | Dados de Mercado e Preço | 142 | Preços, OHLCV, capitalizações de mercado, derivativos, taxas de funding, stablecoins, ganhadores/perdedores, tickers de exchanges |
| 2 | DEX On-Chain e Pool | 46 | Pools DEX, liquidez, pares em alta, histórico de swaps, pontes, volumes de agregadores |
| 3 | Portfólio e Carteira | 93 | Saldos, PnL, posições DeFi, histórico de swaps, participações NFT, histórico multi-chain |
| 4 | Token e Contrato | 40 | Metadados de token, holders, principais traders, resolução ENS, rastreamento de tesouraria, transferências |
| 5 | Protocolo DeFi | 19 | TVL, taxas, yield farming, métricas de chain, tesourarias, emissões |
| 6 | Análise NFT | 59 | Dados de coleção, floors, gráficos de mercado, pools NFT, metadados de traits, vendas |
| 7 | Segurança e Risco | 48 | Detecção de honeypot, verificações de rugpull, risco de aprovação, simulação Tenderly, estimativa de gás |
| 8 | Rede e Infraestrutura | 33 | Saúde da chain, blocos, preços de gás, redes suportadas, infraestrutura Solana |
| 9 | Busca e Descoberta | 19 | Busca 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: 0significa apenas que foi recém-recuperado pelo Hive.sourcereporta o estado de entrega, enquantoorigin_sourcepreserva 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_numberpara 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ável | Descrição |
|---|---|
HIVE_API_KEY | Obrigatório. Chave de API, ou execute hive auth login |
HIVE_API_URL | URL base personalizada (padrão: https://mcp.hiveintelligence.xyz) |
API_EXECUTE_ENDPOINT | Substituir endpoint de execução (avançado) |
Preços
| Plano | Créditos mensais | Limite de taxa | Chaves de API | Preço |
|---|---|---|---|---|
| Grátis | 10.000 | 100 req/min | 5 | Grátis |
| Starter | 100.000 | 300 req/min | 5 | $49/mês |
| Pro | 500.000 | 500 req/min | 10 | $149/mês |
| Enterprise | Personalizado | Personalizado req/min | Personalizado | Personalizado |
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?
| Hive | CoinGecko MCP | Moralis MCP | DeFiLlama MCP | GoPlus only | |
|---|---|---|---|---|---|
| Grupos de provedores | 12 | 1 | 1 | 1 | 1 |
| Categorias | 9 | 2 | 3 | 1 | 1 |
| Total de ferramentas | 525 | ~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) | ✓ | ✓ | parcial | varia | varia |
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
- Início rápido: hiveintelligence.xyz/quick-start
- Referência da API: hiveintelligence.xyz/api-integration
- Guias de instalação: hiveintelligence.xyz/install
- Referência do CLI: hiveintelligence.xyz/cli
- Catálogo de ferramentas: hiveintelligence.xyz/tools/live-catalog
- Habilidades do agente: github.com/hive-intel/hive-skills
Suporte
- GitHub Issues: github.com/hive-intel/hive-sdk/issues
- E-mail: support@hiveintelligence.xyz
- Telegram: t.me/HiveIntelligence
- Twitter / X: @Hive_Intel
Licença
MIT © Hive Intelligence