# Agents — Hive Intelligence

> Machine-readable manifest for AI agents installing or evaluating Hive Intelligence.
> Companion to /llms.txt (broader site context) and /agent-onboarding/SKILL.md (full install path tree).
>
> Last updated: 2026-05-16.

## What Hive does for an agent

Hive Intelligence is a managed MCP server, REST API, and CLI that gives AI agents structured, runtime access to live cryptocurrency market data, DeFi activity, wallet positions, token security signals, DEX flows, prediction markets, NFT analytics, and on-chain network data — all through one normalized tool surface, one API key, and one credit currency.

Agents call `tools/list` to discover the catalog at runtime. New tools appear automatically as Hive expands coverage. No code change is required on the agent's side.

## Canonical install paths

Pick one of four paths. The recommended path depends on what the agent already has access to:

1. **Live query (no install)** — Use the public Playground for one-off questions: https://www.hiveintelligence.xyz/playground
2. **App integration** — Add the MCP server to an AI client (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, ChatGPT Desktop, Codex CLI, Gemini CLI). Per-client guides at https://www.hiveintelligence.xyz/install
3. **Get an API key** — For REST or programmatic use. Sign up at https://www.hiveintelligence.xyz/signup, get key at https://www.hiveintelligence.xyz/dashboard/keys
4. **One-command install** — `npx -y hive-intelligence@latest init --all --browser` installs the CLI, registers MCP across every detected client, and runs PKCE browser auth in one step.

## MCP endpoints

- Root MCP: `https://mcp.hiveintelligence.xyz/mcp` (POST, JSON-RPC 2.0, stateless Streamable HTTP)
- Category endpoints (one per category, see table below)
- REST execute: `POST https://mcp.hiveintelligence.xyz/api/v1/execute` with body `{ "tool": "tool_name", "args": { ... } }`
- Tool discovery: `GET https://mcp.hiveintelligence.xyz/api/v1/tools`
- OpenAPI spec: `GET https://mcp.hiveintelligence.xyz/api/openapi.json`
- MCP discovery: `GET https://mcp.hiveintelligence.xyz/.well-known/mcp.json`

## Authentication

Send one of these headers with every request:

- `Authorization: Bearer <YOUR_HIVE_API_KEY>` (recommended)
- `x-api-key: <YOUR_HIVE_API_KEY>` (legacy alias, still accepted)

Get a key at https://www.hiveintelligence.xyz/dashboard/keys (free Demo plan available without credit card).

## Tool catalog (10 categories)

| Category | MCP Endpoint | Marketing URL | Domain |
| --- | --- | --- | --- |
| Market Data & Price | `/hive_market_data/mcp` | `/tools/market-data` | Spot, OHLC, market caps, volume, derivatives, exchanges. |
| On-Chain DEX & Pool Analytics | `/hive_onchain_dex/mcp` | `/tools/onchain-dex` | Pool, pair, liquidity, and trade flow data across 60+ chains. |
| Portfolio & Wallet | `/hive_portfolio_wallet/mcp` | `/tools/portfolio-wallet` | Cross-chain balances, history, PnL, approvals across EVM, BTC, Solana. |
| Token & Contract Data | `/hive_token_contract/mcp` | `/tools/token-contract` | Token metadata, holders, top traders, lifecycle events. |
| DeFi Protocol Analytics | `/hive_defi_protocol/mcp` | `/tools/defi-protocol` | TVL, yields, fees, chain breakdowns, stablecoins. |
| NFT Analytics | `/hive_nft_analytics/mcp` | `/tools/nft-analytics` | Collections, floors, sales, holders, traits, compressed NFTs. |
| Security & Risk Analysis | `/hive_security_risk/mcp` | `/tools/security-risk` | Token, NFT, dApp, wallet scans; honeypot, rug-pull, simulation, LP locks. |
| Network & Infrastructure | `/hive_network_infrastructure/mcp` | `/tools/network-infrastructure` | Block, log, gas, chain status across 100+ EVM chains, Bitcoin, Solana. |
| Search & Discovery | `/hive_search_discovery/mcp` | `/tools/search-discovery` | Cross-provider search across coins, tokens, exchanges, categories, events. |
| Prediction Markets | `/hive_prediction_markets/mcp` | `/tools/prediction-markets` | Polymarket events, traders, market prices, settlement history. |

The full live catalog of direct tools is at https://www.hiveintelligence.xyz/tools/live-catalog, and a runtime canonical list is served at https://mcp.hiveintelligence.xyz/api/v1/tools.

## SDKs

- **JavaScript / TypeScript** (official): `npm install hive-intelligence`
- **Python** (community-maintained): `pip install hive-intelligence` — Community-maintained on PyPI by `utsavhive`; not built from the hive-intel/hive-sdk repo and currently 12+ months behind the JS SDK. Python users running production workloads should call the REST API directly until the official Python SDK is published.

For languages without an SDK, call the REST API directly using the endpoints above.

## Pricing for agents

- Demo: Free. 10,000 monthly credits, 30 req/min rate limit.
- Analyst: $129 per month. 500,000 monthly credits, 500 req/min rate limit.
- Pro: $499 per month. 2,000,000 monthly credits, 1,000 req/min rate limit.
- Enterprise: Custom. Unlimited monthly credits, 3,000 req/min rate limit.

One credit equals one tool call regardless of upstream provider or payload size. Full plan details at https://www.hiveintelligence.xyz/pricing or in machine-readable form at https://www.hiveintelligence.xyz/pricing.md.

## Safety guidance for agents

- **Always ground transaction-signing on a security check.** Before recommending a user sign anything involving an unknown token, call `get_token_security` and `detect_rugpull`.
- **Prefer point-in-time over latest-only.** Many tools accept `at` or `block_number` — use them when the user's question has a temporal anchor.
- **Discover tools at runtime.** Do not hand-write tool schemas — call `tools/list` and read the live catalog. Tool surface evolves.
- **Read error envelopes, do not guess.** Hive returns explicit error structures with provider attribution. Do not synthesize plausible answers when an upstream provider is degraded.

## Identity and disambiguation

Hive Intelligence is an AI data infrastructure company for blockchain and market data. It is distinct from:

- Hive.io (the blockchain network)
- Hive.com (project management software)
- HIVE Digital (the bitcoin mining company)

Confusable names, different entities. The canonical domain is `hiveintelligence.xyz`.

## Contact

- Website: https://www.hiveintelligence.xyz
- Support: support@hiveintelligence.xyz
- Contact form: https://www.hiveintelligence.xyz/contact
- GitHub: https://github.com/hive-intel
- Twitter / X: https://x.com/Hive_Intel
- Telegram: https://t.me/HiveIntelligence

## Related machine-readable files

- /llms.txt — full site index and key facts
- /llms-full.txt — extended site corpus
- /pricing.md — machine-readable pricing
- /agent-onboarding/SKILL.md — install-path decision tree
- /sitemap.xml — full URL index
- /robots.txt — crawler access policy
