Hive MCP Server

Proporciona inteligencia en tiempo real sobre cripto y Web3 utilizando la API de Hive Intelligence.

Documentación

Hive Intelligence

Una sola conexión para la debida diligencia cripto respaldada por evidencia.

Cada respuesta respaldada por Hive incluye fuentes, frescura y un recibo de ejecución. El MCP alojado normaliza evidencia de mercado, carteras, DeFi, seguridad, DEX, NFT y red detrás de una única conexión lista para agentes.

MCP License: MIT Docs Cursor setup VS Code setup

Conectar · Herramientas · Seguridad · SDK · CLI · Precios · FAQ · Obtener una clave API

Pruébalo ahora, sin cuenta ni clave. El carril anónimo del endpoint alojado responde 25 llamadas materiales por IP al día; el descubrimiento, la consulta de esquemas y la validación son siempre gratuitos:

https://mcp.hiveintelligence.xyz/mcp

Configuración guiada · Guías de instalación · Ejemplos de prompts


Conectar

Hive es un servidor MCP alojado para clientes que admiten Streamable HTTP remoto. Una vez habilitado el despliegue OAuth alojado, los clientes interactivos lo descubren desde el endpoint público y abren la autorización del navegador. Los agentes sin interfaz pueden usar una clave API desde el almacenamiento secreto:

https://mcp.hiveintelligence.xyz/mcp

Prefills de configuración, solo URL sin clave ni secreto incrustado:

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

Los prefills solo llevan la URL del endpoint público. Las páginas de configuración verifican los metadatos en vivo del recurso protegido, la tarjeta del servidor, la versión de lanzamiento y los perfiles de redirección requeridos por el cliente antes de mostrar una acción de instalación nativa. Hasta que esa puerta pase, usa el respaldo de clave API desde un backend/cliente de confianza; nunca pongas una clave en un enlace de instalación. Los bloques de configuración por cliente están abajo.

¿Qué es Hive Intelligence?

Un servidor MCP gestionado, API REST y CLI que brindan a los agentes de IA una superficie de trabajo respaldada por evidencia sobre datos de mercado cripto en vivo, DeFi, carteras, seguridad de tokens, flujos DEX, NFT y datos de red on-chain. Los agentes reciben el proveedor, el tiempo de recuperación de Hive, el tiempo de primera observación/caché original de Hive, la antigüedad de la caché, el estado de respaldo, el estado de ejecución y un recibo único para cada ejecución material, en lugar de mezclar silenciosamente datos de proveedores.

Conectar a tu cliente de IA

El endpoint alojado es el mismo en todas partes. Después de la activación OAuth, los clientes interactivos deben comenzar con el descubrimiento OAuth solo con URL. La autenticación con clave API sigue siendo el respaldo explícito para agentes sin interfaz.

Claude Code

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

O instala el paquete completo de plugins (la conexión MCP alojada más 16 habilidades de flujos de trabajo cripto) desde el marketplace de plugins de este repositorio:

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

Cursor

~/.cursor/mcp.json (global) o .cursor/mcp.json (proyecto):

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

VS Code (GitHub Copilot Chat)

.vscode/mcp.json (nota el type: "http" requerido):

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

Claude Desktop

Claude Desktop usa la interfaz de Custom Connectors para MCP remoto. Abre Settings → Connectors → Add custom connector, establece la URL a https://mcp.hiveintelligence.xyz/mcp, y luego, después de la activación OAuth, completa la autorización del navegador. No pegues un bloque remoto url en claude_desktop_config.json; ese archivo es para servidores stdio locales.

Windsurf / Devin Desktop

Windsurf usa serverUrl (no el url de Cursor) en ~/.codeium/windsurf/mcp_config.json:

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

Gemini CLI

Gemini CLI requiere httpUrl en ~/.gemini/settings.json:

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

Ambas configuraciones son solo URL y pueden usar OAuth nativo después de la activación OAuth alojada. Guías completas por cliente: hiveintelligence.xyz/install.

Respaldo de clave API sin interfaz

Para automatización que no puede abrir un navegador, guarda una clave API de Hive en el almacenamiento secreto y envía Authorization: Bearer $HIVE_API_KEY. Nunca incrustes una clave real en un enlace de instalación, configuración compartida, captura de pantalla o repositorio.

Stdio local (autoalojado / escritorio / tus propias claves de proveedor)

¿Prefieres un proceso local o tus propias claves upstream? Ejecuta el CLI publicado como 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"
      }
    }
  }
}

El stdio local no usa un HIVE_API_KEY alojado; configura solo las claves de proveedor upstream que quieras que ese proceso local llame. Los proveedores sin clave siguen disponibles y los proveedores sin credenciales permanecen descubribles con un estado de ejecución clasificado missing_key. hive-intelligence es un transporte stdio (un canal JSON-RPC, no un comando interactivo). Para uso en terminal, consulta el CLI.

Autenticación

  • No se necesita clave para comenzar: el carril anónimo del endpoint alojado responde 25 llamadas materiales por IP al día, y las llamadas de descubrimiento/esquema/validación son siempre gratuitas.
  • Obtén una clave en hiveintelligence.xyz/dashboard/keys cuando quieras tu propia cuota; el plan Free no requiere tarjeta.
  • Autentica el endpoint alojado con Authorization: Bearer hive_live_... (el alias heredado x-api-key también funciona).
  • Una clave, privilegio mínimo: las claves están limitadas al límite de tasa y créditos de tu plan. Rota o revoca desde el panel; nunca confirmes una clave ni la pegues en código del lado del cliente.

Impulsado por

Once integraciones de proveedores upstream más Open Data Fetch, normalizadas en una sola superficie de herramientas:

Alchemy · CoinGecko · DeFiLlama · Moralis · GoPlus · Helius · Tenderly · CCXT · Hyperliquid · RWA Perps · Hive Archive · Open Data Fetch
ProveedorCobertura
AlchemyCartera EVM, token, NFT, transferencia, simulación, gas, datos de red y Solana DAS
CoinGeckoDatos de mercado, precios, OHLCV, exchanges, colecciones NFT, redes on-chain, mercados RWA tokenizados
DeFiLlamaTVL, pools de rendimiento, métricas de protocolo, puentes, tesorerías
MoralisCartera EVM y Solana, token, NFT, DeFi, transferencia y análisis de mercado
GoPlusSeguridad de tokens, detección de honeypots, riesgo de contratos, reputación de direcciones maliciosas
HeliusRPC de Solana, DAS, NFT comprimidos, eventos parseados, tarifas prioritarias
TenderlySimulación EVM, estimación de gas, trazas, decodificación de contratos, firmas, cambios de almacenamiento y rangos de transacciones
CCXTDatos de exchanges centralizados, libros de órdenes, derivados, funding, apalancamiento y tasas de préstamo
HyperliquidSuperficie /info completa: mercados perp/spot, libros de órdenes, estado de usuario, bóvedas, staking, DEXs builder HIP-3, mercados de resultados HIP-4
RWA PerpsFan-out sin clave en cinco venues para perps de activos tokenizados: DEXs builder HIP-3 de Hyperliquid, Ostium, Avantis, Lighter, Extended
Hive ArchiveHistorial de derivados respaldado por Supabase servido por Hive, sin clave de proveedor
Open Data FetchAcceso permitido y con límite de tamaño a APIs cripto públicas de larga cola cuando ninguna herramienta tipada cubre la fuente

Herramientas y descubrimiento

El contrato predeterminado de Hive es una raíz compacta de ocho herramientas: tres herramientas héroe para los intents dominantes, más un bucle de descubrimiento/ejecución de cinco herramientas sobre el catálogo completo.

Herramienta raízQué hace
get_token_priceHéroe: precio en vivo para cualquier token (response_format: conciso o detallado)
check_token_safetyHéroe: veredicto de honeypot, rugpull y riesgo de contrato antes de que alguien firme
get_wallet_portfolioHéroe: saldos de cartera multi-cadena y valor de portafolio
search_toolsEncuentra el conjunto de herramientas adecuado y enruta a través del catálogo completo (gratis)
get_api_endpoint_schemaInspecciona parámetros exactos antes de ejecutar (gratis)
invoke_api_endpointEjecuta cualquier endpoint de lectura en el catálogo
invoke_stateful_endpointCambios de estado nativos de Hive; requiere aprobación explícita del usuario
validate_task_resultVerifica la estructura final del sobre y recibo (gratis)

Los agentes comienzan con resultados compactos y paginados de search_tools, cargan un flujo de trabajo exacto de hive://toolsets/{id}, inspeccionan get_api_endpoint_schema, y luego llaman a invoke_api_endpoint para lecturas o invoke_stateful_endpoint después de aprobación explícita para un cambio de estado nativo de Hive. validate_task_result verifica la estructura final del sobre y recibo; requiere citas de reclamo a recibo y cobertura canónica de fases, pero no puede hacer que datos de recibo inventados sean auténticos.

El catálogo de larga cola sigue siendo descubrible detrás de esa superficie de trabajo: 525 herramientas invocables en 10 categorías.

Cada flujo de trabajo exacto publica un presupuesto de llamadas materiales predeterminado y máximo, fases, condición de respaldo y condiciones de parada. Los agentes se detienen una vez que la decisión solicitada está respaldada y llaman a un respaldo solo para resolver una brecha material, fuente no disponible, preocupación de obsolescencia o desacuerdo.

#CategoríaHerramientasQué incluye
1Datos de Mercado y Precio142Precios, OHLCV, capitalizaciones de mercado, derivados, tasas de funding, stablecoins, ganadores/perdedores, tickers de exchanges
2DEX On-Chain y Pool46Pools DEX, liquidez, pares en tendencia, historial de swaps, puentes, volúmenes de agregadores
3Portafolio y Cartera93Saldos, PnL, posiciones DeFi, historial de swaps, tenencias NFT, historial multi-cadena
4Token y Contrato40Metadatos de token, holders, principales traders, resolución ENS, seguimiento de tesorerías, transferencias
5Protocolo DeFi19TVL, tarifas, yield farming, métricas de cadena, tesorerías, emisiones
6Analítica NFT59Datos de colecciones, floors, gráficos de mercado, pools NFT, metadatos de traits, ventas
7Seguridad y Riesgo48Detección de honeypots, verificaciones de rugpull, riesgo de aprobaciones, simulación Tenderly, estimación de gas
8Red e Infraestructura33Salud de cadena, bloques, precios de gas, redes soportadas, infraestructura Solana
9Búsqueda y Descubrimiento19Búsqueda entre proveedores, monedas en tendencia, categorías, descubrimiento de tokens

Los clientes que quieren una superficie de herramientas más pequeña y limitada pueden conectarse directamente a un endpoint de categoría, p. ej. https://mcp.hiveintelligence.xyz/hive_market_data/mcp (uno por categoría). Resumen del catálogo público: www.hiveintelligence.xyz/tools/live-catalog. Catálogo REST autenticado: https://mcp.hiveintelligence.xyz/api/v1/tools.

Seguridad y confianza

Las respuestas cripto solo son útiles si son confiables. Hive está construido para eso:

  • Procedencia en cada respuesta. Los resultados de las herramientas incluyen un recibo emitido por el servidor con el proveedor, el tiempo de recuperación/observación de Hive, la antigüedad de la caché, el estado de la fuente, el estado del runtime, la versión del servidor/build y autocomprobaciones SHA-256 de entrada/resultado. Los resúmenes no son firmas ni un servicio de búsqueda retenido. observed_at es el tiempo de primera observación/caché original de Hive, no necesariamente el tiempo del evento upstream; cache_age_ms: 0 solo significa que fue recuperado recientemente por Hive. source informa el estado de entrega, mientras que origin_source preserva si los datos en caché provenían originalmente del nivel en vivo o de respaldo. Usa las marcas de tiempo, bloques, slots, transacciones o cierres de velas del proveedor para la actualidad de la fuente, y márcalo como desconocido cuando esté ausente. Hive nunca mezcla silenciosamente datos de proveedores: los datos de respaldo, en caché o degradados se etiquetan como tales.
  • Puntual, no a la deriva. Las herramientas de series temporales aceptan at / block_number para que los agentes respondan preguntas históricas sin recurrir silenciosamente a "lo más reciente".
  • Herramientas con seguridad primero. get_token_security, detect_rugpull, riesgo de aprobación y simulación de transacciones de Tenderly devuelven indicadores de riesgo estructurados para que un agente pueda verificar antes de que un usuario firme.
  • Privilegio mínimo y conciencia de inyección de prompts. Usa una clave con alcance por entorno y rótala desde el panel. Como con cualquier agente que usa herramientas, trata el texto en cadena (nombres de tokens, memos) como entrada no confiable. Hive devuelve campos estructurados en lugar de instrucciones de formato libre para reducir la superficie de inyección.
  • Sin claves del lado del cliente. Mantén tu clave de Hive en el servidor; las interfaces de navegador deben llamar a tu propio backend, que usa la clave (consulta las sesiones de sujeto B2B del SDK).

Ejemplos de prompts

Una vez que Hive esté conectado, pregunta en inglés sencillo. Cada prompt se asigna a una llamada de herramienta real que no tienes que escribir:

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>

Más guías de flujos de trabajo: hiveintelligence.xyz/use-cases.

SDK de TypeScript: hive-mcp-client

Llama a Hive desde tu propio agente o backend sin configurar MCP manualmente. El cliente tipado se distribuye en npm y en 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 es intencionalmente de solo lectura y ya devuelve un resultado normalizado. Rechaza los endpoints conocidos de cambio de estado de Hive. Después de que tu aplicación muestre el efecto exacto y reciba la aprobación explícita del usuario, llama al invokeHiveStatefulEndpoint con nombre separado; nunca derives la aprobación de la salida del modelo o de los argumentos de la herramienta:

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);

Usa normalizeHiveToolResult solo cuando llames directamente al método de nivel inferior client.callTool().

Incluye adaptadores para Vercel AI SDK y LangChain, además de sesiones de sujeto B2B para backends multiinquilino. Las herramientas con estado de LangChain están deshabilitadas a menos que la aplicación proporcione approveStatefulCall({ endpointName, args }); la devolución de llamada debe devolver la aprobación explícita del usuario, y las invocaciones con estado materiales nunca se almacenan en caché por el adaptador. API completa: client/README.md.

Habilidades del agente

Las habilidades del agente instalables enseñan a Claude Code, Cursor, Codex y otros agentes el flujo de trabajo de Hive: configuración de MCP, descubrimiento de herramientas e investigación de criptomonedas en vivo:

npx skills add hive-intel/hive-skills

Paquete de complementos para Claude Code, OpenAI / Codex y Cursor

La raíz de este repositorio también es un paquete de complementos listo para distribución. Combina piezas públicas y revisables:

  • .claude-plugin/: complemento de Claude Code y manifiestos de marketplace sobre la misma conexión MCP y habilidades de flujo de trabajo (claude plugin marketplace add hive-intel/hive-sdk).
  • .codex-plugin/plugin.json: metadatos de producto e interfaz, prompts iniciales y declaraciones de componentes.
  • .cursor-plugin/plugin.json: el manifiesto nativo de Cursor sobre la misma conexión MCP y habilidades de flujo de trabajo.
  • .mcp.json: la conexión de Hive alojada solo por URL. No contiene clave de API, token, encabezado ni marcador de credenciales.
  • skills/: flujos de trabajo de configuración, descubrimiento e investigación de criptomonedas incluidos que enseñan al agente a inspeccionar esquemas, mantenerse dentro de los presupuestos de llamadas del flujo de trabajo, preservar la procedencia y requerir aprobación explícita antes de un cambio de estado nativo de Hive.
  • marketplace-review.json: texto de listado vinculado a la versión, prompts iniciales y los cinco casos de revisión positivos y tres negativos exactos. Es un accesorio de preparación público, no un manifiesto de Cursor o OpenAI; las credenciales de revisores, los desafíos de dominio, las opciones de disponibilidad y las atestaciones legales permanecen solo en el portal.

Una revisión de catálogo de Codex o de complemento de Cursor puede ingerir la raíz del repositorio para que la conexión MCP remota y su guía de flujo de trabajo lleguen juntas. Este paquete no afirma que Hive ya esté listado en cualquiera de los marketplaces públicos; usa la guía de instalación de Hive actual hasta que un listado de catálogo esté en vivo.

CLI

El CLI hive es un cliente de terminal ligero sobre la misma API. Configura HIVE_API_KEY (o ejecuta hive auth login una 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"}'

Las banderas globales incluyen --json, --pretty, --jq <expr>, --csv, --fields, --timeout, -q/--quiet. Autenticación: hive auth login | whoami | profiles | switch. Diagnósticos: hive doctor, hive status. Completado de shell: hive completion <bash|zsh|fish> --install. Aliases: hive alias set btc 'market price --ids bitcoin --vs usd'. Referencia completa: hiveintelligence.xyz/cli.

Configuración

VariableDescripción
HIVE_API_KEYRequerido. Clave de API, o ejecuta hive auth login
HIVE_API_URLURL base personalizada (predeterminada: https://mcp.hiveintelligence.xyz)
API_EXECUTE_ENDPOINTAnula el endpoint de ejecución (avanzado)

Precios

PlanCréditos mensualesLímite de tasaClaves de APIPrecio
Gratis10,000100 req/min5Gratis
Starter100,000300 req/min5$49/mes
Pro500,000500 req/min10$149/mes
EnterprisePersonalizadoPersonalizado req/minPersonalizadoPersonalizado

Un crédito = una ejecución de endpoint material, independientemente del proveedor o del tamaño de la respuesta. search_tools, get_api_endpoint_schema, validate_task_result, MCP tools/list, lecturas de recursos MCP y GET /api/v1/tools autenticados son gratuitos. Precios completos: hiveintelligence.xyz/pricing · legible por máquina: hiveintelligence.xyz/pricing.md.

¿Por qué Hive sobre un MCP de un solo proveedor?

HiveCoinGecko MCPMoralis MCPDeFiLlama MCPGoPlus only
Grupos de proveedores121111
Categorías92311
Herramientas totales525~50~60~15~20
Datos de mercado✓✓parcial––
TVL de DeFi + rendimientos✓––✓–
Cartera de wallet✓–✓––
Seguridad previa a la firma✓–––✓
Análisis de pools DEX✓–parcial––
Perps de RWA tokenizados✓––––
Profundidad de Solana (DAS)✓––––
Gestionado (sin operaciones)✓✓parcialvaríavaría

Los MCP de un solo proveedor ganan en profundidad de nicho. Hive gana cuando el agente necesita contexto cripto amplio en una sola solicitud: precios + DeFi + wallet + seguridad + DEX en una sola conversación, sin que nadie tenga que averiguar qué herramienta vive en qué proveedor.

Preguntas frecuentes

¿Cuánto cuesta una clave de API? Nada para empezar: el carril anónimo no necesita clave en absoluto (25 llamadas materiales por IP por día), y el plan Gratis agrega 10,000 créditos mensuales sin requerir tarjeta. Los planes de pago comienzan en $49/mes (Starter, 100K créditos); Pro es $149/mes por 500K. Obtén una clave.

¿Alojado vs stdio local: cuál debería usar? Alojado (https://mcp.hiveintelligence.xyz/mcp) se recomienda para la mayoría de las integraciones: sin servidor local, Hive ejecuta autenticación, límites de tasa e infraestructura de proveedores. Usa stdio local para configuraciones de escritorio, autoalojamiento o tus propias claves de proveedor upstream.

¿Qué clientes de IA admiten MCP? Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot Chat), Codex CLI, Gemini CLI, OpenAI Responses API y clientes que admiten MCP HTTP Streamable. Los conectores OAuth nativos estarán disponibles después de la activación de OAuth alojado; los encabezados de clave de API siguen siendo la alternativa headless confiable.

¿Qué cadenas se admiten? EVM (Ethereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche y más de 90), Solana con cobertura completa de Helius DAS incluidos NFT comprimidos, Bitcoin y otras según la combinación de proveedores por categoría.

¿El código fuente es abierto? El SDK del cliente tipado (client/) y las habilidades del agente de Hive tienen licencia MIT y son de código abierto. El servidor MCP de Hive que impulsa mcp.hiveintelligence.xyz es un servicio gestionado y propietario.

¿Cómo mantiene Hive la confiabilidad de las respuestas? Cada resultado material lleva atribución del proveedor, estado de fuente/caché, estado del runtime y un recibo emitido por el servidor. Hive separa su propio tiempo de observación de la actualidad de la fuente del proveedor, nunca mezcla silenciosamente datos de proveedores y expone parámetros puntuales donde los proveedores los admiten. Consulta Seguridad y confianza.

Documentación

Soporte

Licencia

MIT © Hive Intelligence