Hive Intelligence

Introduction

Quick Start Guide

Get connected to the current Hive server in a few minutes.


Option 1: REST API

This is the fastest way to prove your auth, endpoint, and payload shape.

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,ethereum",
      "vs_currencies": "usd"
    }
  }'

The current REST payload keys are tool and args.


Option 2: Root MCP Endpoint

Use the root endpoint when your client supports MCP and you want access to the full discovery flow.

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

Useful root discovery surfaces:

  • tools/list for the compact discovery layer
  • hive://tools for the full live tool inventory
  • get_api_endpoint_schema for parameter lookup

Example MCP call:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_price",
    "arguments": {
      "ids": "bitcoin",
      "vs_currencies": "usd"
    }
  },
  "id": 1
}

Option 3: Category-scoped MCP Endpoint

Use a category endpoint when you want a smaller direct tool surface.

Example:

curl -X POST https://mcp.hiveintelligence.xyz/hive_market_data/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_HIVE_API_KEY" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":1}'

Option 4: CLI

The safest CLI workflow is direct tool execution against the live catalog.

npx hive-intel tools list
npx hive-intel tools info get_price
npx hive-intel tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}'

Verify Tool Discovery

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

If you need the full wrapped catalog, see Live Catalog.


Next
Vision