hive-build

hive-build — Integrate Hive Into App Code

Use this skill when the user is writing code that should call Hive at runtime (a TypeScript app, Python script, Next.js API route, Rust service, LangChain agent, Go cron job...).

If the user just wants live data in this chat, route to hive-query instead. If they're adding Hive to an MCP-capable client, route to hive-mcp. This skill is for "I'm writing code."

Integration path

• TypeScript / custom app default — hive-mcp-client (npm install hive-mcp-client)
• MCP transport — https://mcp.hiveintelligence.xyz/mcp
• REST fallback base — https://mcp.hiveintelligence.xyz/api/v1
• REST execute — POST /execute with {"tool": "...", "args": {...}}
• REST catalog — GET /tools?search=...&limit=...
• Health — GET https://mcp.hiveintelligence.xyz/health

Auth header on every request: Authorization: Bearer $HIVE_API_KEY.

Pattern by language

Python (sync — requests)

import os, requests
from typing import Any

def hive(tool: str, args: dict[str, Any] | None = None) -> dict[str, Any]:
    r = requests.post(
        "https://mcp.hiveintelligence.xyz/api/v1/execute",
        headers={"Authorization": f"Bearer {os.environ['HIVE_API_KEY']}"},
        json={"tool": tool, "args": args or {}},
        timeout=30,
    )
    r.raise_for_status()
    return r.json()

print(hive("get_price", {"ids": "bitcoin", "vs_currencies": "usd"}))

Python (async — httpx)

import os
import asyncio
import httpx

class HiveClient:
    def __init__(self, key: str | None = None):
        key = key or os.environ["HIVE_API_KEY"]
        self._client = httpx.AsyncClient(
            base_url="https://mcp.hiveintelligence.xyz",
            headers={"Authorization": f"Bearer {key}"},
            timeout=httpx.Timeout(30, connect=5),
            limits=httpx.Limits(max_connections=32),
        )

    async def execute(self, tool: str, args: dict | None = None) -> dict:
        r = await self._client.post(
            "/api/v1/execute",
            json={"tool": tool, "args": args or {}},
        )
        r.raise_for_status()
        return r.json()

    async def aclose(self):
        await self._client.aclose()

async def briefing():
    h = HiveClient()
    try:
        prices, tvl, oi = await asyncio.gather(
            h.execute("get_price",         {"ids": "bitcoin,ethereum"}),
            h.execute("get_protocol_tvl",  {}),
            h.execute("get_open_interest", {"exchange": "binance"}),
        )
        return {"prices": prices, "tvl": tvl[:5], "oi": oi}
    finally:
        await h.aclose()