Overview

Hive exposes three primary integration surfaces:

Interface	Endpoint	Purpose
Root MCP	`https://mcp.hiveintelligence.xyz/mcp`	Recommended entry point for LLM and agent workflows
Category-scoped MCP	`https://mcp.hiveintelligence.xyz/hive_*/mcp`	Smaller direct tool surfaces by category
REST API	`https://mcp.hiveintelligence.xyz/api/v1`	Direct HTTP access for listing and executing tools

Current Catalog Shape

10 category-scoped MCP endpoints
Hundreds of categorized tools across those endpoints
348 wrapped provider tools in the full live catalog
13 root MCP discovery tools that route into the provider catalog
9 active provider integrations reflected in hive://providers

Authentication

Use Authorization: Bearer YOUR_HIVE_API_KEY. The legacy x-api-key header is still accepted for older integrations but is no longer recommended — new code should use Bearer.

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 13-tool root discovery layer
hive://tools for the full live tool inventory
hive://categories for the 10 scoped endpoints
hive://providers for provider status
hive://toolsets, hive://skills, and hive://status for task routing, agent skills, and runtime status semantics
get_api_endpoint_schema for exact input parameters
invoke_api_endpoint to execute any wrapped provider tool from root /mcp

Example tool call

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

Category-scoped MCP Endpoints

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

Category	Endpoint
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`
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 "Authorization: Bearer YOUR_HIVE_API_KEY"

This endpoint lists the full live wrapped catalog, not just the 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 "Authorization: Bearer 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.

Key and usage endpoints

Dashboard and CLI auth use the same API host:

Endpoint	Method	Auth	Purpose
`/auth/signup`	`POST`	email/password body	Create a Supabase-backed account and first key
`/auth/login`	`POST`	email/password body	Create a session token
`/auth/me`	`GET`	Supabase bearer token	Read profile and plan
`/api/v1/keys`	`GET`	Supabase bearer token	List API keys
`/api/v1/keys`	`POST`	Supabase bearer token + optional `Idempotency-Key`	Create a one-time-revealed key
`/api/v1/keys/:id`	`DELETE`	Supabase bearer token	Disable a key
`/api/v1/usage`	`GET`	Supabase bearer token or Hive API key	Read plan, credit wallet, and key summary

Health and metadata endpoints

Endpoint	Purpose
`/api/openapi.json`	OpenAPI document for REST clients
`/docs`	Hosted OpenAPI UI
`/api/health`, `/api/health/quick`	General health checks
`/api/health/apis`, `/api/health/:apiName`	Provider health checks
`/api/health/toolsets`, `/api/health/toolsets/:toolsetId`	Task toolset canaries
`/api/health/toolsets/quick`, `/api/health/toolsets/history`	Fast canary status and history
`/status`	Full server status snapshot
`/live`, `/ready`, `/startup`	Runtime lifecycle probes
`/ping`, `/health`	Compatibility health probes

Discovery Resources

Use these from the root MCP endpoint:

hive://providers
hive://categories
hive://tools
hive://toolsets
hive://task-canaries
hive://skills
hive://status

Prompts currently exposed by the server:

analyze_token
compare_protocols
portfolio_audit