Tollkit Crypto
by UltraStarz · remote · no sign-in to list tools · v0.1.0 · published by GitHub user UltraStarz
Crypto news, perps, market pulse, price history and token checks for AI agents. USDC per call.
12 tools: 7 change things and 5 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things7Claude Code: ask: see these tools
- Only reads5Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http tollkit-crypto https://api.tollkit.dev/mcp/cryptoTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
12 tools
Changes things 7Claude Code: ask
check_my_balanceFree.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Check my wallet balance
- readOnlyHint: true
- openWorldHint: true
perps_marketHyperliquid 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 …No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Perps market (Hyperliquid)
- readOnlyHint: true
- openWorldHint: true
pretrade_checkBefore 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 imp…No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Pre-trade token check
- readOnlyHint: true
- openWorldHint: true
token_checkCheck 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 li…No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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. The first 3 calls a day through this tool server are free (no wallet needed). 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).
Annotations the server declares
- title: Token check
- readOnlyHint: true
- openWorldHint: true
token_infoLook 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 chai…No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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. The first 3 calls a day through this tool server are free (no wallet needed). 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.
Annotations the server declares
- title: Token info
- readOnlyHint: true
- openWorldHint: true
wallet_balanceCheck 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 sy…No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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. The first 3 calls a day through this tool server are free (no wallet needed). 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.
Annotations the server declares
- title: Wallet balance
- readOnlyHint: true
- openWorldHint: true
wallet_portfolioValue 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 …No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Wallet portfolio value
- readOnlyHint: true
- openWorldHint: true
Only reads 5Claude Code: allow
crypto_market_pulseGet 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 ref…No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Crypto market pulse
- readOnlyHint: true
- openWorldHint: true
crypto_newsGet 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: po…No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Crypto news
- readOnlyHint: true
- openWorldHint: true
price_historyGet 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 Eth…No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Crypto price history
- readOnlyHint: true
- openWorldHint: true
token_priceGet 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) r…No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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. The first 3 calls a day through this tool server are free (no wallet needed). 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.
Annotations the server declares
- title: Token price
- readOnlyHint: true
- openWorldHint: true
transaction_lookupLook 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 a…No findings
Why it is in this group
- The name "transaction_lookup" says "lookup": a word for reading.
Description, as the server wrote it 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. The first 3 calls a day through this tool server are free (no wallet needed). 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).
Annotations the server declares
- title: Transaction lookup
- readOnlyHint: true
- openWorldHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.1.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http tollkit-crypto https://api.tollkit.dev/mcp/cryptoRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__tollkit-crypto__transaction_lookup",
"mcp__tollkit-crypto__token_price",
"mcp__tollkit-crypto__crypto_news",
"mcp__tollkit-crypto__crypto_market_pulse",
"mcp__tollkit-crypto__price_history"
],
"ask": [
"mcp__tollkit-crypto__check_my_balance",
"mcp__tollkit-crypto__wallet_balance",
"mcp__tollkit-crypto__token_info",
"mcp__tollkit-crypto__token_check",
"mcp__tollkit-crypto__wallet_portfolio",
"mcp__tollkit-crypto__pretrade_check",
"mcp__tollkit-crypto__perps_market"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as tollkit-crypto. Review it before you use it.
