# Hive Intelligence

> Live crypto and macro market data for AI agents. Every answer with its source, its age, and a receipt.
>
> Interactive MCP clients connect with only `https://mcp.hiveintelligence.xyz/mcp` and complete OAuth in the browser. API keys are the explicit fallback for headless agents, REST, CLI, and server-side automation.
>
> Audience: AI agents, agent frameworks, and developer tooling that integrate Hive's MCP, REST, or CLI surfaces. Human readers wanting the same content can use the on-page docs at the linked URLs below.
>
> Last updated: 2026-09-08

## Start Here

- [Documentation](https://docs.hiveintelligence.xyz): Route-by-goal hub covering MCP, CLI, skills, endpoint setup, auth, and example prompts
- [How Hive Works](https://docs.hiveintelligence.xyz/concepts/how-it-works): Stable execution metadata, runtime tool discovery, and what makes crypto data agent-ready
- [Quickstart](https://docs.hiveintelligence.xyz/quickstart): Run the anonymous demo, make a first MCP or CLI request, then choose a production surface
- [Set Up Your Client](https://www.hiveintelligence.xyz/setup): Tabbed client setup guide for every documented Hive MCP client plus the CLI
- [Agent Onboarding (SKILL.md)](https://www.hiveintelligence.xyz/agent-onboarding/SKILL.md): Agent-readable install manifest. If you are an AI agent, fetch this file directly. It tells you which canonical path to follow (live query, app integration, get key, or CLI setup).
- [Agent Skills](https://docs.hiveintelligence.xyz/skills): Human-readable skill pack index with install scope, runtime resources, public skills CLI install path, and all 16 skill mirrors

## Install in Your AI Client

- [All Clients Index](https://docs.hiveintelligence.xyz/install): Pick your client for a dedicated install guide
- [CLI + Skills Setup](https://docs.hiveintelligence.xyz/cli): `npx -y -p hive-intelligence@latest hive init --all --browser` runs the Hive CLI setup wizard for local credentials and supported local agent resources. Use the per-client/API guides for integration-specific MCP details.
- [Claude Desktop](https://docs.hiveintelligence.xyz/install/claude-desktop): Anthropic's macOS/Windows desktop app for Claude.
- [Claude Code](https://docs.hiveintelligence.xyz/install/claude-code): Anthropic's terminal-native coding agent CLI.
- [Cursor](https://docs.hiveintelligence.xyz/install/cursor): AI code editor with native MCP support.
- [Windsurf](https://docs.hiveintelligence.xyz/install/windsurf): Codeium's AI-native IDE with the Cascade agent.
- [VS Code](https://docs.hiveintelligence.xyz/install/vs-code): Visual Studio Code with GitHub Copilot Chat.
- [OpenAI Responses API](https://docs.hiveintelligence.xyz/install/chatgpt): OpenAI's programmatic remote MCP path; ChatGPT custom apps use OAuth in eligible workspaces.
- [Grok](https://docs.hiveintelligence.xyz/install/grok): xAI's chat product with custom remote MCP connectors.
- [Codex CLI](https://docs.hiveintelligence.xyz/install/codex): OpenAI's terminal-native coding agent.
- [Kimi Code CLI](https://docs.hiveintelligence.xyz/install/kimi-cli): Moonshot AI's terminal agent, and the way into Hive for Kimi users.
- [Qwen Code](https://docs.hiveintelligence.xyz/install/qwen-code): Alibaba's Qwen-tuned coding agent for the terminal.
- [Gemini CLI](https://docs.hiveintelligence.xyz/install/gemini-cli): Google's open-source AI coding agent.

## MCP Protocol

- [How It Works](https://docs.hiveintelligence.xyz/concepts/how-it-works): Root endpoint, category endpoints, discovery, example calls, and system data flow
- [Authentication](https://docs.hiveintelligence.xyz/authentication): OAuth-first interactive MCP setup, headless API-key fallback, key handling, and scoped tool access
- [Agent Workflows](https://docs.hiveintelligence.xyz/concepts/workflows): The 12 task toolsets, including the monitor, alert, memory, report, and B2B subject tools
- [Response Format](https://docs.hiveintelligence.xyz/reference/response-format): Normalized response envelope shape
- [Receipts](https://docs.hiveintelligence.xyz/concepts/receipts): Per-call provenance and evidence metadata
- [Error Codes](https://docs.hiveintelligence.xyz/reference/errors): Error types and resolution guidance
- [Rate Limits](https://docs.hiveintelligence.xyz/reference/rate-limits): Per-plan request limits and handling
- [Limits](https://docs.hiveintelligence.xyz/concepts/limits): Credit accounting, payload caps, and concurrency
- [Known Limitations](https://docs.hiveintelligence.xyz/reference/known-limitations): What Hive does not cover, stated up front

## Tool Categories

- [Tools Overview](https://docs.hiveintelligence.xyz/tools): Full catalog across 9 categories
- [Live Catalog](https://docs.hiveintelligence.xyz/tools/live-catalog): Full wrapped provider catalog
- [Market Data & Price](https://docs.hiveintelligence.xyz/tools/market-data): Spot, OHLC, market caps, volume, derivatives, exchanges.
- [On-Chain DEX & Pool Analytics](https://docs.hiveintelligence.xyz/tools/dex-analytics): Pool, pair, liquidity, and trade flow data across major EVM and Solana markets.
- [Portfolio & Wallet](https://docs.hiveintelligence.xyz/tools/portfolio): Wallet balances, history, PnL, approvals across EVM and Solana.
- [Token & Contract Data](https://docs.hiveintelligence.xyz/tools/token-contract): Token metadata, holders, top traders, analytics.
- [DeFi Protocol Analytics](https://docs.hiveintelligence.xyz/tools/defi): TVL, yields, fees, chain breakdowns, stablecoins.
- [NFT Analytics](https://docs.hiveintelligence.xyz/tools/nft): Collections, floors, sales, holders, traits, compressed NFTs.
- [Security & Risk Analysis](https://docs.hiveintelligence.xyz/tools/security): Token, NFT, dApp, wallet scans; honeypot, rug-pull, simulation, LP locks.
- [Network & Infrastructure](https://docs.hiveintelligence.xyz/tools/network): Network lists, gas, block numbers, exchange status, and Solana infrastructure.
- [Search & Discovery](https://docs.hiveintelligence.xyz/tools/search): Cross-provider search across coins, tokens, exchanges, categories, events.

## CLI

- [CLI Reference](https://docs.hiveintelligence.xyz/cli): Install, authenticate, and run Hive from a terminal
- [CLI Commands](https://docs.hiveintelligence.xyz/cli/commands): Every command, flag, and exit code
- [Generic MCP Client](https://docs.hiveintelligence.xyz/install/generic): Connect any header-capable MCP agent, or call Hive from a backend

## Workflow Guides

- [Workflow Guides](https://docs.hiveintelligence.xyz/guides): Task-oriented crypto agent workflows
- [Market Intelligence](https://docs.hiveintelligence.xyz/guides/market-intelligence): Research agents and market scanners
- [Token Security](https://docs.hiveintelligence.xyz/guides/token-security): Honeypot, rug, and risk detection
- [Wallet Analysis](https://docs.hiveintelligence.xyz/guides/wallet-analysis): Portfolio views across chains
- [DeFi Yield](https://docs.hiveintelligence.xyz/guides/defi-yield): Yield comparison and protocol health
- [Trading Bot](https://docs.hiveintelligence.xyz/guides/trading-bot): Price, liquidity, and execution data

## Docs and Reference

- [Data Sources](https://docs.hiveintelligence.xyz/concepts/data-sources): The upstream providers Hive normalizes
- [Skill Packs](https://docs.hiveintelligence.xyz/skills/packs): Every published skill pack and its install scope
- [Changelog](https://docs.hiveintelligence.xyz/reference/changelog): Release notes and product changes
- [FAQ](https://docs.hiveintelligence.xyz/reference/faq): Common questions about MCP, the CLI, and the catalog

## MCP Endpoint

- Base URL: https://mcp.hiveintelligence.xyz
- Root MCP: POST https://mcp.hiveintelligence.xyz/mcp
- Interactive MCP auth: URL-only OAuth 2.1 browser authorization
- Headless and CLI auth: `Authorization: Bearer <YOUR_HIVE_API_KEY>`
- Legacy headless auth alias: `x-api-key: <YOUR_HIVE_API_KEY>`
- Authenticated tool discovery: GET https://mcp.hiveintelligence.xyz/api/v1/tools
- Get a headless/API key: https://www.hiveintelligence.xyz/login?next=/dashboard/connect

## Optional

- [Pricing](https://www.hiveintelligence.xyz/pricing): Free (free, No API key needed to start), Starter ($49/mo, 100,000 monthly credits), Pro ($149/mo, 500,000 monthly credits), Enterprise (custom)
- [Privacy Policy](https://www.hiveintelligence.xyz/privacy): Data handling and privacy practices
- [Terms of Service](https://www.hiveintelligence.xyz/terms): Usage terms and conditions

## Machine-readable files for AI agents

- [Machine-readable pricing](https://www.hiveintelligence.xyz/pricing.md): Plan tiers, credits, rate limits, and endpoints in plain markdown for AI buyers
- [Agent install manifest](https://www.hiveintelligence.xyz/agents.md): Canonical install paths, MCP endpoints, and safety guidance for autonomous agents
- [Agent onboarding skill](https://www.hiveintelligence.xyz/agent-onboarding/SKILL.md): Decision-tree manifest. Fetch this if you are an AI agent and want a single source of truth for install paths
- [Agent skills index](https://docs.hiveintelligence.xyz/skills): Human-readable install and skill-pack reference
- [Hive skill pack index](https://www.hiveintelligence.xyz/skills/index.json): Agent skill pack metadata mirrored from the MCP product contract
- [Public Hive skills mirror](https://github.com/hive-intel/hive-skills): install with `npx skills add hive-intel/hive-skills` or list with `npx skills add hive-intel/hive-skills --list`
- [Site llms-full.txt](https://www.hiveintelligence.xyz/llms-full.txt): Extended site corpus for context-window-friendly ingestion

## Key Facts

- Live crypto and macro market data for AI agents.
- Every answer with its source, its age, and a receipt.
- Interactive MCP setup is URL-only with browser OAuth; API keys are for headless agents, REST, CLI, and server-side automation
- Founded in 2024 by Rishabh Narang (CEO, ex-derivatives trader, previously founded Sharpe Labs in 2021)
- Headless and API workflows use one Hive key instead of stitching together Alchemy, CoinGecko, DeFiLlama, GoPlus, CCXT, Helius, Hyperliquid, Open Data Fetch, Tenderly, Moralis, Hive Archive, RWA Perps. See https://docs.hiveintelligence.xyz/concepts/data-sources for the full normalized provider inventory
- 9 category-scoped MCP endpoints (Market Data & Price, On-Chain DEX & Pool Analytics, Portfolio & Wallet, Token & Contract Data, DeFi Protocol Analytics, NFT Analytics, Security & Risk Analysis, Network & Infrastructure, Search & Discovery)
- 8 compact root MCP tools (`search_tools`, `get_api_endpoint_schema`, `invoke_api_endpoint`, `invoke_stateful_endpoint`, `validate_task_result` plus hero tools `get_token_price`, `check_token_safety`, `get_wallet_portfolio`) route agents to 534 callable tools
- 516 provider tools are exposed through the 9 category MCP endpoints; 18 Hive-native monitor, memory, alert, report, and B2B subject tools bring the full callable catalog to 534. Canonical count comes from authenticated REST discovery at https://mcp.hiveintelligence.xyz/api/v1/tools
- Documented MCP client or API-path support for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, OpenAI Responses API, Grok, Codex CLI, Kimi Code CLI, Qwen Code, Gemini CLI
- Agent skills install through `npx skills add hive-intel/hive-skills` or the CLI setup path `npx -y -p hive-intelligence@latest hive init --all --browser`
- Pricing: Free (free, No API key needed to start), Starter ($49/mo, 100,000 monthly credits), Pro ($149/mo, 500,000 monthly credits), Enterprise (custom)
- Investors / advisor lineage (shared with Sharpe Labs): Google Cloud, NVIDIA, AWS, Anthropic, Animoca Brands, Morningstar Ventures, GBV Capital, Contango Digital
- Distinct from Hive.io (blockchain), Hive.com (project management), and HIVE Digital (bitcoin mining)

## Contact

- Website: https://www.hiveintelligence.xyz
- Support: support@hiveintelligence.xyz
- Twitter / X: https://x.com/Hive_Intel
- GitHub: https://github.com/hive-intel/hive-sdk
- Telegram: https://t.me/HiveIntelligence
- Founder LinkedIn: https://www.linkedin.com/in/rishabhnarang/
- Founder X: https://x.com/whorishabhnarang


---

## Extended client install reference

### Claude Desktop
- Slug: `claude-desktop`
- Tagline: Anthropic's macOS/Windows desktop app for Claude.
- Config file (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: customConnectorUi
- Note: Add the remote endpoint via Settings → Connectors → Custom → Web, then complete OAuth in the browser. Available on Free (1 connector), Pro, Max, Team, Enterprise.
- Official docs: https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
- Hive install guide: https://docs.hiveintelligence.xyz/install/claude-desktop

### Claude Code
- Slug: `claude-code`
- Tagline: Anthropic's terminal-native coding agent CLI.
- Config file (macOS): `~/.claude.json (managed via `claude mcp add`)`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: streamableHttp
- Note: Recommended path. Add the hosted URL and complete OAuth in the browser. API-key headers remain available for headless automation.
- Official docs: https://docs.anthropic.com/en/docs/claude-code/mcp
- Hive install guide: https://docs.hiveintelligence.xyz/install/claude-code

### Cursor
- Slug: `cursor`
- Tagline: AI code editor with native MCP support.
- Config file (macOS): `~/.cursor/mcp.json`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: streamableHttp
- Official docs: https://cursor.com/docs/context/mcp
- Hive install guide: https://docs.hiveintelligence.xyz/install/cursor

### Windsurf
- Slug: `windsurf`
- Tagline: Codeium's AI-native IDE with the Cascade agent.
- Config file (macOS): `~/.codeium/windsurf/mcp_config.json`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: streamableHttp
- Official docs: https://docs.windsurf.com/windsurf/cascade/mcp
- Hive install guide: https://docs.hiveintelligence.xyz/install/windsurf

### VS Code
- Slug: `vs-code`
- Tagline: Visual Studio Code with GitHub Copilot Chat.
- Config file (macOS): `.vscode/mcp.json (per-project) or User Profile (global)`
- Config key: `servers`
- Config format: json
- Recommended transport: streamableHttp
- Note: Requires `type: "http"` and VS Code 1.102 or newer. URL-only config uses OAuth discovery; `headers` with `${input:...}` remains a manual API-key fallback, while `env` is for stdio servers.
- Official docs: https://code.visualstudio.com/docs/copilot/customization/mcp-servers
- Hive install guide: https://docs.hiveintelligence.xyz/install/vs-code

### OpenAI Responses API
- Slug: `chatgpt`
- Tagline: OpenAI's programmatic remote MCP path; ChatGPT custom apps use OAuth in eligible workspaces.
- Config file (macOS): `n/a (server-side Responses API `tools` request)`
- Config key: `tools[].server_url`
- Config format: json
- Recommended transport: streamableHttp
- Note: Use the Responses API `tools` array with `type: "mcp"`, Hive's `server_url`, and an `authorization` API-key token for headless agents. Eligible ChatGPT Business and Enterprise/Edu workspaces can create a custom app with the same endpoint and complete OAuth in the browser.
- Official docs: https://platform.openai.com/docs/guides/tools-remote-mcp
- Hive install guide: https://docs.hiveintelligence.xyz/install/chatgpt

### Grok
- Slug: `grok`
- Tagline: xAI's chat product with custom remote MCP connectors.
- Config file (macOS): `n/a (grok.com/connectors)`
- Config key: `MCP server URL`
- Config format: json
- Recommended transport: customConnectorUi
- Note: Go to grok.com/connectors, choose New Connector → Custom, enter the public MCP URL, and complete OAuth. xAI documents connectors for all Grok users; organization policy may still restrict custom connectors.
- Official docs: https://docs.x.ai/grok/connectors
- Hive install guide: https://docs.hiveintelligence.xyz/install/grok

### Codex CLI
- Slug: `codex`
- Tagline: OpenAI's terminal-native coding agent.
- Config file (macOS): `~/.codex/config.toml`
- Config key: `mcp_servers`
- Config format: toml
- Recommended transport: streamableHttp
- Note: Use `bearer_token_env_var = "HIVE_API_KEY"` to avoid writing the key to disk; or `http_headers = { Authorization = "Bearer ..." }` for inline keys.
- Official docs: https://developers.openai.com/codex/config-reference
- Hive install guide: https://docs.hiveintelligence.xyz/install/codex

### Kimi Code CLI
- Slug: `kimi-cli`
- Tagline: Moonshot AI's terminal agent, and the way into Hive for Kimi users.
- Config file (macOS): `~/.kimi-code/mcp.json`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: streamableHttp
- Note: OAuth is first-class: `kimi mcp add --transport http --auth oauth hive <url>` then `kimi mcp auth hive`. For headless use, `--header "Authorization: Bearer <key>"`.
- Official docs: https://moonshotai.github.io/kimi-cli/en/customization/mcp.html
- Hive install guide: https://docs.hiveintelligence.xyz/install/kimi-cli

### Qwen Code
- Slug: `qwen-code`
- Tagline: Alibaba's Qwen-tuned coding agent for the terminal.
- Config file (macOS): `~/.qwen/settings.json`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: streamableHttp
- Note: Header auth is the documented path: `qwen mcp add --transport http hive <url> --header "Authorization: Bearer <key>"`, or `httpUrl` + `headers` in settings.json. Its OAuth support expects an explicit `oauth.clientId`/`tokenUrl`, where Hive issues clients by dynamic registration, so the guide leads with the header.
- Official docs: https://qwenlm.github.io/qwen-code-docs/en/users/features/mcp/
- Hive install guide: https://docs.hiveintelligence.xyz/install/qwen-code

### Gemini CLI
- Slug: `gemini-cli`
- Tagline: Google's open-source AI coding agent.
- Config file (macOS): `~/.gemini/settings.json`
- Config key: `mcpServers`
- Config format: json
- Recommended transport: streamableHttp
- Official docs: https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md
- Hive install guide: https://docs.hiveintelligence.xyz/install/gemini-cli

## Upstream provider details

- **Alchemy** (https://www.alchemy.com): EVM wallet, token, NFT, transfer, simulation, gas, and network RPC data
- **CoinGecko** (https://www.coingecko.com): Market data, OHLC, trending coins, exchange data, tokenized RWA markets, news
- **DeFiLlama** (https://defillama.com): TVL, yields, fees, stablecoins, chain analytics
- **GoPlus** (https://gopluslabs.io): Token, NFT, dApp, wallet security and risk analysis
- **CCXT** (https://github.com/ccxt/ccxt): Centralized exchange spot, derivatives, funding rates
- **Helius** (https://www.helius.dev): Solana RPC, Digital Asset Standard, priority fees, parsed transactions, Parsed Events
- **Hyperliquid** (https://hyperliquid.xyz): Perpetual DEX volume, funding, candles, open-interest caps, and builder DEX discovery, HIP-4 outcome markets
- **Open Data Fetch** (https://www.hiveintelligence.xyz): Allowlisted, size-capped access to long-tail public crypto APIs when no typed tool covers the source
- **Tenderly** (https://tenderly.co): EVM transaction simulation, gas estimation, calldata decoding
- **Moralis** (https://moralis.com): Wallet, token, NFT analytics across EVM and Solana
- **Hive Archive** (https://mcp.hiveintelligence.xyz): Cross-venue crypto derivatives history since November 2023 across 33 CEX and DEX venues: settled funding rates, open interest, basis, long/short ratio, and liquidations from Hive's own archive store
- **RWA Perps** (https://mcp.hiveintelligence.xyz): Cross-venue tokenized real-world-asset perp funding and markets (Hyperliquid HIP-3 builder dexes, Ostium, Avantis, Lighter, Extended) with mechanism-true normalization fields

## SDK details

### TypeScript MCP client adapter
- Status: Officially maintained
- Availability: npm `hive-mcp-client@0.1.5`
- Install/source: npm install hive-mcp-client
- Registry URL: https://www.npmjs.com/package/hive-mcp-client
- Adapter source: https://github.com/hive-intel/hive-sdk/tree/main/client
- Disclosure: Official typed adapter for custom TypeScript applications. The public source mirror is hive-intel/hive-sdk under client/. REST remains available for non-TypeScript stacks.

### Python
- Status: Community-maintained
- Availability: pypi `hive-intelligence@0.1.0`
- Install/source: pip install hive-intelligence
- Registry URL: https://pypi.org/project/hive-intelligence/
- Disclosure: Community-maintained on PyPI by `utsavhive`; not built from the canonical Hive MCP repo and currently 12+ months behind the public MCP/REST contract. Python users running production workloads should call the REST API directly until the official Python SDK is published.

## Agent framework integrations

- **LangChain** (https://www.langchain.com): No dedicated integration guide yet. Frameworks call the REST API or a header-capable MCP client.
- **CrewAI** (https://www.crewai.com): No dedicated integration guide yet. Frameworks call the REST API or a header-capable MCP client.
- **Eliza** (https://www.elizaos.ai): No dedicated integration guide yet. Frameworks call the REST API or a header-capable MCP client.

## Public repositories and registry metadata

- Public SDK and support repo: https://github.com/hive-intel/hive-sdk
- Hosted MCP endpoint: https://mcp.hiveintelligence.xyz/mcp
- Public MCP registry id: `xyz.hiveintelligence/mcp`
- Public Hive skills mirror: https://github.com/hive-intel/hive-skills
- Skills CLI install: `npx skills add hive-intel/hive-skills`

## Runtime facts

- Hosted server version: `1.6.0`
- Public npm CLI package license metadata: UNLICENSED
- TypeScript adapter and public skill pack license: MIT
- Hosted source note: the managed server source is not published; the public package, typed adapter, and skill mirrors expose the installable integration surface.
- MCP registry name: `xyz.hiveintelligence/mcp`
- Pinned MCP SDK version: `1.30.0`