The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Hive Sdk listing page.
One connection for evidence-backed crypto due diligence.
Every Hive-backed answer carries sources, freshness, and a runtime receipt. The hosted MCP normalizes market, wallet, DeFi, security, DEX, NFT, and network evidence behind one agent-ready connection.
Connect · Tools · Security · SDK · CLI · Pricing · FAQ · Get an API key
Try it now, with no account and no key. The hosted endpoint's anonymous lane answers 25 material calls per IP per day; discovery, schema lookup, and validation are always free:
Hive is a hosted MCP server for clients that support remote Streamable HTTP. Once the hosted OAuth deployment is enabled, interactive clients discover it from the public endpoint and open browser authorization. Headless agents can use an API key from secret storage:
One-click config prefills, URL-only with no key or secret embedded:
The prefills carry only the public endpoint URL. The setup pages check the live protected-resource metadata, server card, release version, and required client redirect profiles before showing a native install action. Until that gate passes, use the API-key fallback from a trusted backend/client; never put a key in an install link. Per-client config blocks are below.
A managed MCP server, REST API, and CLI that give AI agents one evidence-backed workflow surface over live crypto market data, DeFi, wallets, token security, DEX flows, NFTs, and on-chain network data. Agents receive the provider, Hive retrieval time, Hive first-observation/original cache time, cache age, fallback state, runtime status, and a unique receipt for every material execution instead of silently mixing provider data.
The hosted endpoint is the same everywhere. After OAuth activation, interactive clients should start with URL-only OAuth discovery. API-key auth remains the explicit headless fallback.
Or install the full plugin bundle (the hosted MCP connection plus 16 crypto workflow skills) from this repository's plugin marketplace:
~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
.vscode/mcp.json (note the required type: "http"):
Claude Desktop uses the Custom Connectors UI for remote MCP. Open Settings →
Connectors → Add custom connector, set the URL to
https://mcp.hiveintelligence.xyz/mcp, then, after OAuth activation, complete
browser authorization. Do not paste a remote url block into
claude_desktop_config.json; that file is for local stdio servers.
Windsurf uses serverUrl (not Cursor's url) in
~/.codeium/windsurf/mcp_config.json:
Gemini CLI requires httpUrl in ~/.gemini/settings.json:
Both configs are URL-only and can use native OAuth after hosted OAuth activation. Full per-client guides: hiveintelligence.xyz/install.
For automation that cannot open a browser, keep a Hive API key in secret
storage and send Authorization: Bearer $HIVE_API_KEY. Never embed a real key
in an install link, shared config, screenshot, or repository.
Prefer a local process or your own upstream keys? Run the published CLI as a stdio MCP server:
Local stdio does not use a hosted HIVE_API_KEY; configure only the upstream
provider keys you want that local process to call. Keyless providers remain
available and providers without credentials stay discoverable with a classified
missing_key runtime status. hive-intelligence is a stdio transport (a
JSON-RPC channel, not an interactive command). For terminal use, see the
CLI.
Authorization: Bearer hive_live_... (legacy alias x-api-key also works).Eleven upstream provider integrations plus Open Data Fetch, normalized into one tool surface:
| Provider | Coverage |
|---|---|
| Alchemy | EVM portfolio, token, NFT, transfer, simulation, gas, network data, and Solana DAS |
| CoinGecko | Market data, prices, OHLCV, exchanges, NFT collections, on-chain networks, tokenized RWA markets |
| DeFiLlama | TVL, yield pools, protocol metrics, bridges, treasuries |
| Moralis | EVM and Solana wallet, token, NFT, DeFi, transfer, and market analytics |
| GoPlus | Token security, honeypot detection, contract risk, malicious-address reputation |
| Helius | Solana RPC, DAS, compressed NFTs, Parsed Events, priority fees |
| Tenderly | EVM simulation, gas estimation, traces, contract decode, signatures, storage changes, and transaction ranges |
| CCXT | Centralized exchange data, order books, derivatives, funding, leverage, and borrow rates |
| Hyperliquid | Full /info surface: perp/spot markets, order books, user state, vaults, staking, HIP-3 builder DEXs, HIP-4 outcome markets |
| RWA Perps | Keyless five-venue fan-out for tokenized-asset perps: Hyperliquid HIP-3 builder DEXs, Ostium, Avantis, Lighter, Extended |
| Hive Archive | Supabase-backed derivatives history served by Hive, no provider key |
| Open Data Fetch | Allowlisted, size-capped access to long-tail public crypto APIs when no typed tool covers the source |
Hive's default contract is a compact eight-tool root: three hero tools for the dominant intents, plus a five-tool discovery/execution loop over the full catalog.
| Root tool | What it does |
|---|---|
get_token_price | Hero: live price for any token (response_format: concise or detailed) |
check_token_safety | Hero: honeypot, rugpull, and contract-risk verdict before anyone signs |
get_wallet_portfolio | Hero: multi-chain wallet balances and portfolio value |
search_tools | Find the right task toolset and route across the full catalog (free) |
get_api_endpoint_schema | Inspect exact parameters before executing (free) |
invoke_api_endpoint | Execute any read endpoint in the catalog |
invoke_stateful_endpoint | Hive-native state changes; requires explicit user approval |
validate_task_result | Check the final envelope and receipt structure (free) |
Agents start with compact,
paginated search_tools results, load one exact hive://toolsets/{id} workflow,
inspect get_api_endpoint_schema, then call invoke_api_endpoint for reads or
invoke_stateful_endpoint after explicit approval for a Hive-native state
change. validate_task_result checks the final envelope and receipt structure;
it requires claim-to-receipt citations and canonical phase coverage, but cannot
make invented receipt data authentic.
The long-tail catalog remains discoverable behind that workflow surface: 534 callable tools across 9 categories.
Every exact workflow publishes a default and maximum material-call budget, phases, fallback condition, and stop conditions. Agents stop once the requested decision is supported and call a fallback only to resolve a material gap, unavailable source, staleness concern, or disagreement.
| # | Category | Tools | What's inside |
|---|---|---|---|
| 1 | Market Data & Price | 147 | Prices, OHLCV, market caps, derivatives, funding rates, stablecoins, gainers/losers, exchange tickers |
| 2 | On-Chain DEX & Pool | 46 | DEX pools, liquidity, trending pairs, swap history, bridges, aggregator volumes |
| 3 | Portfolio & Wallet | 96 | Balances, PnL, DeFi positions, swap history, NFT holdings, multi-chain history |
| 4 | Token & Contract | 40 | Token metadata, holders, top traders, ENS resolution, treasury tracking, transfers |
| 5 | DeFi Protocol | 25 | TVL, fees, yield farming, chain metrics, treasuries, emissions |
| 6 | NFT Analytics | 59 | Collection data, floors, market charts, NFT pools, trait metadata, sales |
| 7 | Security & Risk | 51 | Honeypot detection, rugpull checks, approval risk, Tenderly simulation, gas estimation |
| 8 | Network & Infrastructure | 33 | Chain health, blocks, gas prices, supported networks, Solana infrastructure |
| 9 | Search & Discovery | 19 | Cross-provider search, trending coins, categories, token discovery |
Clients that want a smaller, scoped tool surface can connect to a category endpoint directly, e.g. https://mcp.hiveintelligence.xyz/hive_market_data/mcp (one per category). Public catalog overview: www.hiveintelligence.xyz/tools/live-catalog. Authenticated REST catalog: https://mcp.hiveintelligence.xyz/api/v1/tools.
Crypto answers are only useful if they're trustworthy. Hive is built for that:
observed_at is Hive's first-observation/original cache time, not necessarily the upstream event time; cache_age_ms: 0 only means newly retrieved by Hive. source reports the delivery state, while origin_source preserves whether cached data originally came from the live or fallback tier. Use provider timestamps, blocks, slots, transactions, or candle closes for source recency, and mark it unknown when absent. Hive never silently mixes provider data: fallback, cached, or degraded data is labeled as such.at / block_number so agents answer historical questions without quietly defaulting to "latest."get_token_security, detect_rugpull, approval-risk, and Tenderly transaction simulation return structured risk flags so an agent can check before a user signs.Once Hive is connected, ask in plain English. Each prompt maps to a real tool call you don't have to write:
More workflow guides: hiveintelligence.xyz/use-cases.
hive-mcp-clientCall Hive from your own agent or backend without wiring MCP by hand. The typed client ships on npm and in client/:
invokeHiveEndpoint is intentionally read-only and already returns a
normalized result. It rejects known Hive state-changing endpoints. After your
application shows the exact effect and receives explicit user approval, call
the separately named invokeHiveStatefulEndpoint; never derive approval from
model output or tool arguments:
Use normalizeHiveToolResult only when you call the lower-level
client.callTool() method directly.
Includes Vercel AI SDK and LangChain adapters, plus B2B subject sessions for
multi-tenant backends. LangChain stateful tools are disabled unless the app
supplies approveStatefulCall({ endpointName, args }); the callback must return
the user's explicit approval, and material stateful invocations are never
adapter-cached. Full API: client/README.md.
Installable agent skills teach Claude Code, Cursor, Codex, and other agents the Hive workflow: MCP setup, tool discovery, and live crypto research:
This repository root is also a distribution-ready plugin bundle. It combines public, reviewable pieces:
.claude-plugin/: Claude Code plugin and marketplace
manifests over the same MCP connection and workflow skills
(claude plugin marketplace add hive-intel/hive-sdk)..codex-plugin/plugin.json: product and
interface metadata, starter prompts, and component declarations..cursor-plugin/plugin.json: the
Cursor-native manifest over the same MCP connection and workflow skills..mcp.json: the URL-only hosted Hive connection. It contains
no API key, token, header, or credential placeholder.skills/: bundled setup, discovery, and crypto-research
workflows that teach the agent to inspect schemas, stay within workflow call
budgets, preserve provenance, and require explicit approval before a
Hive-native state change.marketplace-review.json: release-bound listing
copy, starter prompts, and the exact five positive plus three negative review
cases. It is a public preparation fixture, not a Cursor or OpenAI manifest;
reviewer credentials, domain challenges, availability choices, and legal
attestations remain portal-only.A Codex catalog or Cursor plugin review can ingest the repository root so the remote MCP connection and its workflow guidance arrive together. This bundle does not claim that Hive is already listed in either public marketplace; use the current Hive install guide until a catalog listing is live.
The hive CLI is a thin terminal client over the same API. Set HIVE_API_KEY (or run hive auth login once):
Global flags include --json, --pretty, --jq <expr>, --csv, --fields, --timeout, -q/--quiet. Auth: hive auth login | whoami | profiles | switch. Diagnostics: hive doctor, hive status. Shell completion: hive completion <bash|zsh|fish> --install. Aliases: hive alias set btc 'market price --ids bitcoin --vs usd'. Full reference: hiveintelligence.xyz/cli.
| Variable | Description |
|---|---|
HIVE_API_KEY | Required. API key, or run hive auth login |
HIVE_API_URL | Custom base URL (default: https://mcp.hiveintelligence.xyz) |
API_EXECUTE_ENDPOINT | Override execute endpoint (advanced) |
| Plan | Monthly credits | Rate limit | API keys | Price |
|---|---|---|---|---|
| Free | 10,000 | 100 req/min | 5 | Free |
| Starter | 100,000 | 300 req/min | 5 | $49/mo |
| Pro | 500,000 | 500 req/min | 10 | $149/mo |
| Enterprise | Custom | Custom req/min | Custom | Custom |
One credit = one material endpoint execution, regardless of provider or response size. search_tools, get_api_endpoint_schema, validate_task_result, MCP tools/list, MCP resource reads, and authenticated GET /api/v1/tools are free. Full pricing: hiveintelligence.xyz/pricing · machine-readable: hiveintelligence.xyz/pricing.md.
| Hive | CoinGecko MCP | Moralis MCP | DeFiLlama MCP | GoPlus only | |
|---|---|---|---|---|---|
| Provider groups | 12 | 1 | 1 | 1 | 1 |
| Categories | 9 | 2 | 3 | 1 | 1 |
| Total tools | 534 | ~50 | ~60 | ~15 | ~20 |
| Market data | ✓ | ✓ | partial | – | – |
| DeFi TVL + yields | ✓ | – | – | ✓ | – |
| Wallet portfolio | ✓ | – | ✓ | – | – |
| Pre-signing security | ✓ | – | – | – | ✓ |
| DEX pool analytics | ✓ | – | partial | – | – |
| Tokenized RWA perps | ✓ | – | – | – | – |
| Solana depth (DAS) | ✓ | – | – | – | – |
| Managed (no ops) | ✓ | ✓ | partial | varies | varies |
Single-provider MCPs win on niche depth. Hive wins when the agent needs broad crypto context in one request: prices + DeFi + wallet + security + DEX in a single conversation, without anyone figuring out which tool lives in which provider.
What does an API key cost? Nothing to start: the anonymous lane needs no key at all (25 material calls per IP per day), and the Free plan adds 10,000 monthly credits with no card required. Paid plans start at $49/month (Starter, 100K credits); Pro is $149/month for 500K. Get a key.
Hosted vs local stdio: which should I use?
Hosted (https://mcp.hiveintelligence.xyz/mcp) is recommended for most integrations: no local server, Hive runs auth, rate limits, and provider infrastructure. Use local stdio for desktop setups, self-hosting, or your own upstream provider keys.
Which AI clients support MCP? Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (Copilot Chat), Codex CLI, Gemini CLI, OpenAI Responses API, and clients that support Streamable HTTP MCP. Native OAuth connectors become available after hosted OAuth activation; API-key headers remain the trusted headless fallback.
What chains are supported? EVM (Ethereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche, and 90+ more), Solana with full Helius DAS coverage including compressed NFTs, Bitcoin, and others depending on the provider mix per category.
Is the source code open?
The typed client SDK (client/) and the Hive agent skills are MIT-licensed and open source. The Hive MCP server that powers mcp.hiveintelligence.xyz is a managed, proprietary service.
How does Hive keep answers trustworthy? Every material result carries provider attribution, source/cache state, runtime status, and a server-minted receipt. Hive separates its own observation time from provider source recency, never silently mixes provider data, and exposes point-in-time parameters where providers support them. See Security & trust.
MIT © Hive Intelligence