Skip to main content
When your agent connects to https://mcp.hiveintelligence.xyz/mcp, it sees nine tools. Each one answers a research job you can say in a sentence, such as “is this token safe?” or “how is BTC positioned?”. Behind each tool Hive runs a fixed set of catalog calls and returns one answer. Every data call needs a signed-in account. See authentication.

How an answer is shaped

The multi-part tools return one object with a sections map. Each section has a status and, when it ran, its own source:
A few rules hold for every tool:
  • A section that failed is listed under missing with its status and error. Hive never fills it in with a guess.
  • A section that does not apply is not_applicable with a reason, for example liquidity for a native coin like ETH.
  • If every section failed, the whole call fails with code BUNDLE_UNAVAILABLE and the credits are refunded.
  • detail: "full" returns more rows per section. The default, summary, keeps the answer small.
  • get_token_price and check_token_safety return one answer with a source_receipt instead of sections.

How pricing works

Each tool has a fixed price that covers its default sections. Each optional section you add costs 1 more credit. Leaving a default section out does not lower the price. A call that fails as a whole costs nothing. For example, research_token with the defaults costs 5 credits. Adding supply and top_traders makes it 7.

find_token

Resolves a name, ticker or contract address to the token people mean: its CoinGecko id, symbol, market cap, and contract on each chain. When several tokens share a name or ticker, it returns ranked candidates instead of picking one. Copycat tokens reuse names, so call this first when you only have a name.
When several listed tokens use the same ticker, warning says so. When you name a chain the token has no contract on, token.contract is null and token.note says why. match is resolved, ambiguous or not_found. A token is resolved only when one exact match clearly leads on market cap. When a rival with a tenth of its market cap or more exists, the answer is ambiguous and next_action asks you to pick a candidate. A contract address returns the token’s on-chain info under sections. Price: 1 credit.

get_token_price

The current price for one token, with market cap and 24h change.
Price: 1 credit.

check_token_safety

A security screen for one contract from GoPlus: honeypot, buy and sell taxes, ownership flags, and a summary of LP lock status, top-holder concentration and creator balances with plain-language verdicts.
risk_flags are raw GoPlus values, where "1" means flagged. An empty verdicts list means no scam signal fired. It does not mean the token is safe. Price: 1 credit.

research_token

One due-diligence report on a token. Use it for “is this token real, liquid and safe?”
The answer carries token, chain, a resolved block with the id, symbol and contract it used, then sections and missing. market has price, market cap, FDV, 24h volume and 7d and 30d change. liquidity lists the top DEX pools. insights is CoinGecko’s AI summary and is marked unverified. If the name matches several tokens, the call fails with code AMBIGUOUS_TOKEN, lists the candidates, and is not charged. Call it again with one candidate’s id, or with its contract and chain. A name with no match fails with TOKEN_NOT_FOUND. Price: 5 credits for the defaults, plus 1 for each of supply, insights and top_traders.

analyze_wallet

What a wallet holds and what it has been doing. It replaces get_wallet_portfolio, which still works when called by name.
The answer carries address, chain, sections and missing. On a Solana wallet, perps, predictions, nfts, risk and approvals come back not_applicable. Price: 1 credit for holdings, plus 1 for each extra section.

market_positioning

How a coin’s derivatives market is positioned across venues, now or over a window.
With window: "now", funding is read live from the venues you list, and liquidations cover the last 24 hours. Any other window reads history from the Hive Archive and reports each venue’s latest value, its value at the start of the window, and the change. Liquidations are totalled per venue and side on the server, with longs_liquidated_usd and shorts_liquidated_usd at the top. Live funding rates are raw fractions for one funding interval, and intervals differ by venue. How far back the archive goes: Price: 4 credits for the defaults, plus 1 for each optional metric.

market_overview

What is moving in crypto right now.
movers has gainers and losers. Pool sections list name, address, reserve, 24h volume and 24h price change. Hot pools use a 24h window when you ask for 7d. With a global scope, new_pools lists Ethereum pools. Price: 3 credits for the defaults, plus 1 for each optional section.

defi_yields

DeFi data from DeFiLlama, in two modes. Pass protocols to compare one or two protocols on TVL and fees. Leave it out to search for the best yields.
Yield rows are sorted by APY and carry apy_percent, base_apy_percent, reward_apy_percent, tvl_usd and the pool id. Protocol sections are named per protocol, for example tvl_aave and fees_aave. Price: 2 credits, plus 1 for stablecoins.

prediction_markets

Market-implied odds from Polymarket and Kalshi. Search a topic on both venues, or look up one market. Pass query or market. One of them is required.
Sections are named per venue, for example polymarket_odds and kalshi_history. A price is what the market pays for an outcome, not the probability that it happens. Matching the same question across the two venues is best effort. Price: 2 credits, plus 1 for each of history and orderbook.

The long tail: the developer profile

The nine tools cover the common jobs. The full catalog, about 420 provider tools across ten categories, stays reachable in three ways. The developer profile. Connect your client to this URL instead of the root:
It adds three tools next to the nine: search_tools finds a catalog tool from a plain description, get_api_endpoint_schema returns its exact parameters, and invoke_api_endpoint runs it. Each catalog call costs 1 credit. The CLI. hive tools search, hive tools info and hive tools call reach the same catalog from a terminal. See CLI commands. The category pages in this section describe what each part of the catalog covers.

Example prompts

What to say to your AI client to trigger each tool.