Package Architecture

Use this page when you need to choose the right Hive package, transport, or endpoint for a production integration. For first-run setup, start with Get Started or Install Hive.

Package surfaces

Remote MCP and REST are hosted at mcp.hiveintelligence.xyz; local MCP stdio and terminal workflows ship in hive-intelligence. Custom TypeScript applications can use the official hive-mcp-client adapter. npm is currently v0.1.5, while the public hive-intel/hive-sdk mirror under client/ contains the v0.2.0 release candidate. Verify the published version before using the new stateful-router APIs. REST remains the stable path for non-TypeScript stacks and low-level integrations.

The local executable is named hive, which differs from the package name, so npx uses -p hive-intelligence@latest to pick the package and then hive as the binary.

Remote MCP clients

Configure Hive as an MCP server in your AI client. The managed endpoint is https://mcp.hiveintelligence.xyz/mcp, and the recommended transport is remote Streamable HTTP wherever the client supports it.

Claude Desktop

Claude Desktop adds remote MCP servers through its Custom Connectors UI, not through claude_desktop_config.json.

Name: Hive
URL: https://mcp.hiveintelligence.xyz/mcp
Authentication: OAuth (complete in browser)

Use the local stdio option in the Claude Desktop guide when you need a subprocess or want to supply provider credentials directly.

Cursor

Open Cursor Settings, navigate to MCP, and add a new remote server with this config:

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

VS Code

Add this to .vscode/mcp.json:

{
  "servers": {
    "hive": {
      "type": "http",
      "url": "https://mcp.hiveintelligence.xyz/mcp"
    }
  }
}

For Windsurf, Gemini CLI, OpenAI Responses API, Codex CLI, and local stdio configs, use the dedicated install guide or the unified setup page.

REST API

REST has no client package. Send a POST request directly:

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

The payload keys are tool and args. See the API Integration page for the full REST reference.

TypeScript MCP client

The typed adapter is currently published on npm as hive-mcp-client@0.1.5; its public source mirror contains the 0.2.0 release candidate. Check the published version, then install it from npm:

npm install hive-mcp-client

import {
  createHiveMcpClient,
  invokeHiveEndpoint,
} from 'hive-mcp-client';

const hive = await createHiveMcpClient({
  apiKey: process.env.HIVE_API_KEY,
  clientName: 'my-app',
});

const prices = await invokeHiveEndpoint(hive, 'get_price', {
  ids: 'bitcoin,ethereum',
  vs_currencies: 'usd',
});

console.log(prices.json ?? prices.text);

The adapter keeps custom apps on the same discovery/schema/execution path as MCP agents. For non-TypeScript stacks, use the REST API directly.

The current adapter source includes:

• core MCP helpers such as createHiveMcpClient, searchHiveTools, getHiveEndpointSchema, invokeHiveEndpoint, normalizeHiveToolCall, rankHiveCategoriesForQuery, normalizeHiveToolResult, and readHiveMetadataSnapshot
• hive-mcp-client/b2b for signed subject sessions, B2B readiness checks, hive-mcp doctor, and adapter methods for watchlist digest monitors, risk watches, token discovery risk, alerts, reports, memory facts, monitor cleanup, forSubject(), callForSubject(), and subject audit reads
• hive-mcp-client/ai-sdk for Vercel AI SDK MCP transport config and ranked/core/all tool selection
• hive-mcp-client/langchain for LangChain tools over Hive's compact root MCP surface; install @langchain/core only in apps that use this export

searchHiveTools, getHiveEndpointSchema, and invokeHiveEndpoint already return normalized results. Use normalizeHiveToolResult only when your code calls client.callTool() directly.

Keep HIVE_API_KEY and HIVE_SUBJECT_SIGNING_SECRET in server-side runtime config. Browser code should call your own backend instead of importing the adapter directly.

CLI

Run tools from the terminal through the published npm package. The package is hive-intelligence and the executable is hive, so npx needs -p to pick the package before naming the binary:

HIVE_API_KEY=YOUR_KEY npx -y -p hive-intelligence@latest hive market price --ids bitcoin --vs usd

Or install globally and call hive directly:

npm install -g hive-intelligence
hive auth login
hive market price --ids bitcoin --vs usd

See the CLI Reference for all available commands.

Get your API key

1. Go to /dashboard/keys
2. Enter your email address
3. Open the sign-in link sent to your inbox
4. Copy your API key from the dashboard

The email sign-in flow is passwordless. After you confirm the email link, copy your API key from the dashboard.

Next steps

• Install Hive - connect a supported AI client
• Quick Start - verify your setup with a live request
• API Integration - exact REST and MCP request contracts
• MCP Integration Tutorial - connect Hive to an AI agent step by step
• Playground - explore tools interactively