Current REST Contract

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

Action	Endpoint	Notes
Discover tools	`GET /api/v1/tools`	Use this to inspect the live catalog and schemas
Execute a tool	`POST /api/v1/execute`	Send JSON with `tool` and `args`

Older REST examples that use toolName and arguments are legacy.

Execute Example

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"
    }
  }'

Response Example

{
  "bitcoin": {
    "usd": 67234.0
  }
}

Most tools return provider-shaped JSON directly, so you should validate against each tool schema rather than assuming one shared wrapper.

MCP For Agents

Use the root MCP server when you want resource discovery and schema lookup:

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

Use category-scoped MCP endpoints when you want a smaller direct tools/list surface, for example:

/hive_market_data/mcp
/hive_security_risk/mcp
/hive_portfolio_wallet/mcp
/hive_prediction_markets/mcp

Helpful MCP discovery resources:

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

Language Guides

Guide	Focus
JavaScript	Browser, Node.js, and TypeScript integrations
Python	Scripts, data pipelines, and backend services
Go	Typed backends and concurrent services
Java	JVM services with `HttpClient`
Rust	Async services with `reqwest`

Minimal Examples

Python

import requests

response = requests.post(
    "https://mcp.hiveintelligence.xyz/api/v1/execute",
    headers={"x-api-key": "YOUR_HIVE_API_KEY"},
    json={
        "tool": "get_price",
        "args": {"ids": "bitcoin", "vs_currencies": "usd"},
    },
    timeout=30,
)

print(response.json())

JavaScript

const response = await fetch("https://mcp.hiveintelligence.xyz/api/v1/execute", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.HIVE_API_KEY,
  },
  body: JSON.stringify({
    tool: "get_price",
    args: { ids: "bitcoin", vs_currencies: "usd" },
  }),
});

console.log(await response.json());

Go

payload := map[string]any{
    "tool": "get_price",
    "args": map[string]any{
        "ids": "bitcoin",
        "vs_currencies": "usd",
    },
}

Java

Map<String, Object> payload = Map.of(
    "tool", "get_price",
    "args", Map.of("ids", "bitcoin", "vs_currencies", "usd")
);

Rust

let payload = json!({
    "tool": "get_price",
    "args": { "ids": "bitcoin", "vs_currencies": "usd" }
});