hive-sdk
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 20 GitHub stars
Code Fail
- exec() — Shell command execution in .github/workflows/publish-server.yml
- process.env — Environment variable access in .github/workflows/publish-server.yml
- fs module — File system access in .github/workflows/publish-server.yml
- process.env — Environment variable access in glama-stdio-wrapper.mjs
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Public SDK, CLI, and docs for Hive Intelligence: crypto MCP access for AI agents.
Hive Intelligence
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 · CLI · Pricing · FAQ · Get an API key
Connect, then sign in. Add the hosted endpoint to your client; it opens a
browser sign-in (GitHub, Google, or an email code) the first time a tool runs.
The Free plan gives 10,000 monthly credits with no card:https://mcp.hiveintelligence.xyz/mcp
Connect
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:
https://mcp.hiveintelligence.xyz/mcp
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.
What is Hive Intelligence?
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.
Connect to your AI client
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.
Claude Code
claude mcp add --transport http --scope user hive https://mcp.hiveintelligence.xyz/mcp
Or install the full plugin bundle (the hosted MCP connection plus 16 crypto
workflow skills) from this repository's plugin marketplace:
claude plugin marketplace add hive-intel/hive-sdk
claude plugin install hive@hive
Cursor
~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"hive": {
"url": "https://mcp.hiveintelligence.xyz/mcp"
}
}
}
VS Code (GitHub Copilot Chat)
.vscode/mcp.json (note the required type: "http"):
{
"servers": {
"hive": {
"type": "http",
"url": "https://mcp.hiveintelligence.xyz/mcp"
}
}
}
Claude Desktop
Claude Desktop uses the Custom Connectors UI for remote MCP. Open Settings →
Connectors → Add custom connector, set the URL tohttps://mcp.hiveintelligence.xyz/mcp, then, after OAuth activation, complete
browser authorization. Do not paste a remote url block intoclaude_desktop_config.json; that file is for local stdio servers.
Windsurf / Devin Desktop
Windsurf uses serverUrl (not Cursor's url) in~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"hive": {
"serverUrl": "https://mcp.hiveintelligence.xyz/mcp"
}
}
}
Gemini CLI
Gemini CLI requires httpUrl in ~/.gemini/settings.json:
{
"mcpServers": {
"hive": {
"httpUrl": "https://mcp.hiveintelligence.xyz/mcp"
}
}
}
Both configs are URL-only and can use native OAuth after hosted OAuth
activation. Full per-client guides:
hiveintelligence.xyz/install.
Headless API-key fallback
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.
Local stdio (desktop clients / self-host)
For clients that only launch local processes, such as Claude Desktop'sclaude_desktop_config.json, run the published CLI as a stdio MCP server. By
default it proxies to the hosted endpoint, so it serves the same production
tools and data, authenticated with the key saved by hive auth login (tool
calls ask you to sign in without one):
{
"mcpServers": {
"hive": {
"command": "npx",
"args": ["-y", "-p", "hive-intelligence@latest", "hive"]
}
}
}
Always launch hive-intelligence@latest. npx hive-mcp installs an unrelated
npm package, and npx hive-intelligence without @latest can keep running an
old version. hive doctor --fix repairs configs that do either.
To self-host with your own upstream provider keys, append "serve", "--local"
to args (or set HIVE_STDIO_MODE=local).
Local stdio does not use a hosted HIVE_API_KEY in that mode; 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.
Authentication
- Every tool call needs sign-in: OAuth in clients that support it, or an API key. Connecting and listing tools works before you sign in.
- Get a key at hiveintelligence.xyz/dashboard/keys; the Free plan needs no card.
- Authenticate the hosted endpoint with
Authorization: Bearer hive_live_...(legacy aliasx-api-keyalso works). - One key, least privilege: keys are scoped to your plan's rate limit and credits. Rotate or revoke from the dashboard; never commit a key or paste it into client-side code.
Powered by
Ten upstream provider integrations plus Open Data Fetch, normalized into one tool surface:
Alchemy · CoinGecko · DeFiLlama · GoPlus · Helius · Tenderly · Goldsky · CCXT · Hyperliquid · RWA Perps · Hive Archive · Open Data Fetch
| 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 |
| 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 |
| Goldsky | EVM node reads on ~150 chains incl. HyperEVM: contract reads, logs, traces, archive, priced wallet balances and transfers |
| 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 three-venue fan-out for tokenized-asset perps: Hyperliquid HIP-3 builder DEXs, 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 |
Tools & discovery
Hive's default contract is a compact six-tool root: three hero tools for the
dominant intents, plus a three-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 tool 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 |
Agents start with compact, paginated search_tools results, inspectget_api_endpoint_schema, then call invoke_api_endpoint for reads.
The long-tail catalog remains discoverable behind that workflow surface: 435
callable tools across 10 categories.
| # | Category | Tools | What's inside |
|---|---|---|---|
| 1 | Market Data & Price | 142 | 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 | 93 | 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 | 19 | 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 | 48 | 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 |
Public catalog overview: www.hiveintelligence.xyz/tools/live-catalog. Authenticated REST catalog: https://mcp.hiveintelligence.xyz/api/v1/tools.
Security & trust
Crypto answers are only useful if they're trustworthy. Hive is built for that:
- Provenance on every response. Tool results carry a server-minted receipt with provider, Hive retrieval/observation time, cache age, source state, runtime status, server/build version, and SHA-256 input/result self-checks. The digests are not signatures or a retained lookup service.
observed_atis Hive's first-observation/original cache time, not necessarily the upstream event time;cache_age_ms: 0only means newly retrieved by Hive.sourcereports the delivery state, whileorigin_sourcepreserves 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. - Point-in-time, not drift. Time-series tools accept
at/block_numberso agents answer historical questions without quietly defaulting to "latest." - Security-first tools.
get_token_security,detect_rugpull, approval-risk, and Tenderly transaction simulation return structured risk flags so an agent can check before a user signs. - Least privilege & prompt-injection awareness. Use a scoped key per environment and rotate from the dashboard. As with any tool-using agent, treat on-chain text (token names, memos) as untrusted input. Hive returns structured fields rather than free-form instructions to reduce injection surface.
- No client-side keys. Keep your Hive key server-side; browser UIs should call your own backend, which uses the key.
Example prompts
Once Hive is connected, ask in plain English. Each prompt maps to a real tool call you don't have to write:
What's the price of BTC, ETH, and SOL right now in USD?
List the top 20 yield pools above 10% APY on Ethereum.
Show me the portfolio of vitalik.eth across all chains.
Is this token a honeypot? 0x... · Run a rugpull check on $PEPE.
What are the current funding rates for BTC perps across exchanges?
What is the funding on the tokenized TSLA perp across the RWA venues right now?
Simulate this transaction before I sign it: <tx hash or calldata>
More workflow guides: hiveintelligence.xyz/use-cases.
Agent skills
Installable agent skills teach Claude Code, Cursor, Codex, and other agents the Hive workflow: MCP setup, tool discovery, and live crypto research:
npx skills add hive-intel/hive-sdk # every skill
npx skills add hive-intel/hive-sdk --skill hive --yes # the front door only
npx skills add hive-intel/hive-sdk --list # see what is available
Claude Code, OpenAI / Codex, and Cursor plugin bundle
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.
CLI
The hive CLI is a thin terminal client over the same API. Set HIVE_API_KEY (or run hive auth login once):
hive tools call get_token_price --token bitcoin # a price
hive tools call check_token_safety --address 0x... # token safety
hive tools call get_wallet_portfolio --address 0x... # wallet portfolio
hive tools search "funding rate" # search the 435-tool catalog
hive tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}'
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.
Configuration
| 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) |
Pricing
| Plan | Monthly credits | Rate limit | API keys | Price |
|---|---|---|---|---|
| Free | 10,000 | 100 req/min | 25 | Free |
| Starter | 100,000 | 300 req/min | 25 | $49/mo |
| Pro | 500,000 | 500 req/min | 25 | $149/mo |
| Enterprise | Custom | Custom req/min | 25 | Custom |
One credit = one material endpoint execution, regardless of provider or response size. search_tools, get_api_endpoint_schema, 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.
Why Hive over a single-provider MCP?
| Hive | CoinGecko MCP | Moralis MCP | DeFiLlama MCP | GoPlus only | |
|---|---|---|---|---|---|
| Provider groups | 11 | 1 | 1 | 1 | 1 |
| Categories | 9 | 2 | 3 | 1 | 1 |
| Total tools | 435 | ~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.
FAQ
What does an API key cost?
Nothing to start: the Free plan gives 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 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.
Documentation
- Quick Start: hiveintelligence.xyz/quick-start
- API Reference: hiveintelligence.xyz/api-integration
- Install Guides: hiveintelligence.xyz/install
- CLI Reference: hiveintelligence.xyz/cli
- Tool Catalog: hiveintelligence.xyz/tools/live-catalog
- Agent Skills: github.com/hive-intel/hive-sdk/tree/main/skills
Support
- GitHub Issues: github.com/hive-intel/hive-sdk/issues
- Email: [email protected]
- Telegram: t.me/HiveIntelligence
- Twitter / X: @Hive_Intel
License
MIT © Hive Intelligence
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found