Tollkit Crypto MCP Server

Check a token before buying, sending or accepting it, on Base, Ethereum or Solana: what it is, its USD price and liquidity, and plain warnings read from the chain (no pool, thin liquidity; on Base and Ethereum the contract's owner and whether it is upgradeable or can mint, pause, blacklist or set fees; on Solana an active mint or freeze authority). $0.004 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: Before buying, accepting or sending an unfamiliar token. Use instead: pretrade_check when you're about to trade a specific amount (adds price impact, your holding and news); token_info for the basics only. Parameters: token: ERC-20 contract or SPL mint. chain: base (default), ethereum or solana. Returns: what the token is, price and liquidity, and plain-language warnings (owner, upgradeable, can mint, pause, blacklist or set fees; Solana mint or freeze authority).

Look up a token on Base, Ethereum (ERC-20 contract) or Solana (SPL mint): name, symbol, decimals and total supply, plus mint and freeze authority on Solana, read live from the chain. Use it to confirm what an address actually is before acting on it. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You have a token address and need to know what it is before acting on it. Use instead: token_check for safety warnings and liquidity; token_price for its price. Parameters: token: ERC-20 contract or SPL mint. chain: base (default), ethereum or solana. Returns: name, symbol, decimals, total supply; on Solana, mint and freeze authority.

Get a token's current USD price on Base, Ethereum or Solana, read from its deepest on-chain pool (Uniswap v3 against USDC or WETH; on Solana, Orca Whirlpools against USDC or SOL) rather than a price API. Returns the pool used, how much liquidity backs the price, and a flag when the pool is too thin to trust. $0.001 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need a token's current USD price straight from the chain. Use instead: price_history for past prices; token_check for price plus safety warnings; crypto_market_pulse for BTC, ETH and SOL at once. Parameters: token: ERC-20 contract or SPL mint ("SOL" works on Solana). chain: base (default), ethereum or solana. Returns: price_usd, the pool used, its liquidity, and a thin_liquidity flag when the price shouldn't be trusted.

Get the crypto market at a glance in one call: the Crypto Fear & Greed Index (today, yesterday, a week ago), BTC, ETH and SOL with perp price, 24h change, funding and Chainlink reference price, the highest and lowest funding rates, the biggest 24h gainers and losers, and Hyperliquid's total open interest and volume. $0.003 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You want the state of the crypto market in one call, for example before deciding anything else. Use instead: perps_market for specific coins or more markets; crypto_news for the headlines behind a move. Returns: Fear & Greed (today, yesterday, a week ago), BTC, ETH and SOL with perp price, 24h change, funding and Chainlink price, funding extremes, top gainers and losers, and Hyperliquid totals. Takes no parameters.

Get recent crypto news for a coin or topic: up to 10 articles from the past hour, day or week with publisher, date, snippet and link, plus a short AI read of the coverage (mood: positive, negative, mixed or neutral; a summary; main themes) written only from those headlines. A read of the news, not advice. $0.004 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You want what's being said about a coin or the market right now. Use instead: web_search with type "news" for non-crypto topics; crypto_market_pulse for numbers instead of headlines. Parameters: query: a coin or topic; leave it out for the whole market. freshness: hour, day (default) or week. num: 1-10 articles, default 8. Returns: articles[] with title, publisher, date, snippet and link, plus mood (positive, negative, mixed or neutral), a summary and themes, written only from those headlines.

Check a wallet's balances on Base, Ethereum or Solana: native ETH or SOL, USDC (plus USDT on Ethereum and Solana), and any token contracts or SPL mints you list (up to 20), with symbols and decimals applied. Read live from the chain. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need what a wallet holds, in token amounts. Use instead: wallet_portfolio for USD values and a total; check_my_balance (free) for your own USDC on Base. Parameters: address is required. chain: base (default), ethereum or solana; the address format must match. tokens: up to 20 extra ERC-20 contracts or SPL mints to include. Returns: native coin, USDC (USDT on Ethereum and Solana) and the tokens you listed, each with symbol, decimals and amount.

Value a wallet in USD on Base, Ethereum or Solana: each holding (native coin, USDC/USDT and any tokens you list) priced from on-chain pools, the total, and warnings for thin pools or positions bigger than their pool. $0.005 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need a wallet's value in USD: each holding priced and the total. Use instead: wallet_balance when amounts are enough (cheaper). Parameters: address is required. chain: base (default), ethereum or solana. tokens: up to 20 extra contracts or mints to include. Returns: holdings[] with amount, USD price, USD value and pool used, the total in USD, and warnings for thin pools or positions bigger than their pool.

Free. Check how much USDC is left in your own wallet on Base, so you can tell your human before you run out. Returns the balance and whether it's below your threshold. Read-only: it moves nothing. Tollkit never holds anyone's funds or keys. When to use: You pay for tools from a wallet and want to know if it's running low. Use instead: wallet_balance for any wallet, chain or token. Parameters: address: the wallet you pay from. network: base (default) or sepolia. low_below: your low-balance threshold in USDC, default 1. Returns: the USDC balance and whether it's below low_below. Free.

Hyperliquid perpetuals: mark and oracle price, 24h change, current hourly funding rate (positive means longs pay shorts) and annualized, open interest in coins and USD, 24h volume and max leverage. Name up to 20 coins, or leave coins out to get the top markets sorted by volume, open interest, funding or 24h move. funding_hours adds hourly funding history for one coin. $0.001 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need perpetual futures data from Hyperliquid: funding, open interest, leverage, or the top markets. Use instead: crypto_market_pulse for a one-call market overview; token_price for an on-chain spot price. Parameters: coins: up to 20 Hyperliquid names (e.g. BTC, ETH, kPEPE); leave out for the top markets. sort and limit (default volume, 10) apply only when coins is left out. funding_hours (1-168) adds hourly funding history and needs exactly one coin. Returns: markets[] with mark, oracle and mid price, 24h change, hourly and annualized funding (positive: longs pay shorts), open interest in coins and USD, 24h volume and max leverage; not_found for unknown names.

Before trading a token on Base, Ethereum or Solana: its USD price and liquidity, plain warnings read from the chain, how big your planned trade is next to the pool (rough price impact), how much your wallet already holds, and recent web results about the token. Facts, not advice. $0.01 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: Right before a trade, to see if the size is sane for the pool and what's being said about the token. Use instead: token_check when you aren't trading yet. Parameters: token is required. chain: base (default), ethereum or solana. amount_usd: your planned size, for price impact against pool depth. wallet: your address, to show what you already hold. Returns: price, liquidity, chain warnings, rough price impact for amount_usd, your current holding, and recent web results. Facts, not advice.

Get past USD prices for a crypto asset (ETH, BTC, SOL, LINK and others with a Chainlink feed) over up to 365 days: up to 100 points read from Chainlink's on-chain price feed on Ethereum, each with its time and round, plus first, last, high, low and percent change. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need past prices for a major asset: a trend, a high or low, or the change over a period. Use instead: token_price for the current price of any token, including ones without a Chainlink feed. Parameters: asset: a symbol with a Chainlink USD feed (ETH, BTC, SOL, LINK and others). days: 1-365, default 7. points: 2-100 evenly spaced prices, default 24. Returns: points[] each with time, price_usd and Chainlink round, plus first, last, high, low and percent change.

The mood on X (Twitter) about a coin or crypto topic in the last 24 hours: bullish, bearish, mixed or quiet, a score from -1 (very bearish) to 1 (very bullish), how many posts were read, up to three short themes, and links to representative posts. Giveaways, bots and paid promotion are ignored. Posts are unverified and can be coordinated, so treat it as information, not a trading signal. $0.15 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You want to know what crypto traders on X (Twitter) are saying about a coin right now: the mood and why. Use instead: crypto_news for published articles; crypto_market_pulse for numbers (Fear & Greed, funding). Parameters: coin: a symbol or name (SOL, BONK), or query: a crypto topic. Up to 60 characters. Returns: mood (bullish, bearish, mixed or quiet), score from -1 to 1, posts_read, up to three themes, posts[] links to X posts, and a note that posts are unverified.

Look up a transaction on Base, Ethereum or Solana: did it succeed, when, who sent it, the fee, and every token movement with symbols and amounts (ERC-20 transfers; on Solana, SOL and token balance changes per owner). Use it to confirm a payment actually landed. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You have a transaction hash and need to know if it went through and what moved. Parameters: hash: 0x hash on Base or Ethereum, base58 signature on Solana. chain: base (default), ethereum or solana; it must match the hash. Returns: status, time, sender, fee, and every token transfer with symbol and amount (on Solana, balance changes per owner).