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 asections map. Each section has a status and,
when it ran, its own source:
- A section that failed is listed under
missingwith its status and error. Hive never fills it in with a guess. - A section that does not apply is
not_applicablewith a reason, for example liquidity for a native coin like ETH. - If every section failed, the whole call fails with code
BUNDLE_UNAVAILABLEand the credits are refunded. detail: "full"returns more rows per section. The default,summary, keeps the answer small.get_token_priceandcheck_token_safetyreturn one answer with asource_receiptinstead 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.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.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?”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 replacesget_wallet_portfolio, which
still works when called by name.
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.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. Passprotocols to compare one or two protocols on
TVL and fees. Leave it out to search for the best yields.
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.
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: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.

