Technical
API Integration Documentation
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
- 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_KEYAuthorization: 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/listfor the compact root discovery layerhive://toolsfor the full live tool inventoryhive://categoriesfor the 14 scoped endpointshive://providersfor provider statusget_api_endpoint_schemafor 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.
| 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 |
| 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:
searchlimitcursorsort=nameorder=asc|descfields=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
toolandargs. OldertoolName/argumentsexamples are legacy.
Discovery Resources
Use these from the root MCP endpoint:
hive://providershive://categorieshive://tools
Prompts currently exposed by the server:
analyze_tokencompare_protocolsportfolio_audit