Hive Intelligence

Technical

API Integration Documentation

Overview

Hive exposes three primary integration surfaces:

InterfaceEndpointPurpose
Root MCPhttps://mcp.hiveintelligence.xyz/mcpRecommended entry point for LLM and agent workflows
Category-scoped MCPhttps://mcp.hiveintelligence.xyz/hive_*/mcpSmaller direct tool surfaces by category
REST APIhttps://mcp.hiveintelligence.xyz/api/v1Direct HTTP access for listing and executing tools

Current Catalog Shape

  • 14 category-scoped MCP endpoints
  • 389 categorized tools across those endpoints
  • 512 live direct tools in the full wrapped catalog
  • 9 active provider integrations reflected in hive://providers

Authentication

Use either:

  • x-api-key: YOUR_HIVE_API_KEY
  • Authorization: Bearer YOUR_HIVE_API_KEY

The examples below use x-api-key.


Root MCP

Endpoint: POST https://mcp.hiveintelligence.xyz/mcp

The root endpoint is designed for discovery-heavy AI workflows.

What to use on root MCP

  • tools/list for the compact root discovery layer
  • hive://tools for the full live tool inventory
  • hive://categories for the 14 scoped endpoints
  • hive://providers for provider status
  • get_api_endpoint_schema for exact input parameters

Example tool call

curl -X POST https://mcp.hiveintelligence.xyz/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: YOUR_HIVE_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "get_price",
      "arguments": {
        "ids": "bitcoin",
        "vs_currencies": "usd"
      }
    },
    "id": 1
  }'

Category-scoped MCP Endpoints

These endpoints expose direct tools/list results for one slice of the catalog.

CategoryEndpoint
Market Data/hive_market_data/mcp
DEX Analytics/hive_onchain_dex/mcp
Portfolio & Wallet/hive_portfolio_wallet/mcp
Token & Contract/hive_token_contract/mcp
DeFi Protocols/hive_defi_protocol/mcp
NFT Analytics/hive_nft_analytics/mcp
Security & Risk/hive_security_risk/mcp
Network & Infrastructure/hive_network_infrastructure/mcp
Search & Discovery/hive_search_discovery/mcp
Stocks & Equities/hive_stocks_equities/mcp
Forex & Commodities/hive_forex_commodities/mcp
Economic Indicators/hive_economic_indicators/mcp
Alternative Data/hive_alternative_data/mcp
Prediction Markets/hive_prediction_markets/mcp

REST API

Base URL: https://mcp.hiveintelligence.xyz/api/v1

List tools

curl -X GET "https://mcp.hiveintelligence.xyz/api/v1/tools?search=price&limit=10" \
  -H "x-api-key: YOUR_HIVE_API_KEY"

This endpoint lists the full live wrapped catalog, not just the 389 categorized tools.

Useful query params:

  • search
  • limit
  • cursor
  • sort=name
  • order=asc|desc
  • fields=name,title,description,inputSchema

Execute a tool

curl -X POST https://mcp.hiveintelligence.xyz/api/v1/execute \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_HIVE_API_KEY" \
  -d '{
    "tool": "get_price",
    "args": {
      "ids": "bitcoin",
      "vs_currencies": "usd"
    }
  }'

The current REST payload keys are tool and args. Older toolName / arguments examples are legacy.


Discovery Resources

Use these from the root MCP endpoint:

  • hive://providers
  • hive://categories
  • hive://tools

Prompts currently exposed by the server:

  • analyze_token
  • compare_protocols
  • portfolio_audit