API Reference

58 tools · MCP endpoint at https://toolbooth.io/mcp · Pay USDC per call via x402

Quick Start

Add to your MCP client config:

{ "mcpServers": { "toolbooth": { "url": "https://toolbooth.io/mcp" } } }

No API keys needed. Your agent discovers tools automatically and pays per call.

All Tools
token_price $0.0005

Get current USD price for any Solana token by mint address. Returns price, symbol, and supply info.

params: mintAddress

Get a complete wallet profile: SOL balance, all token holdings with USD values, NFT count, and top holdings ranked by value.

params: walletAddress

Analyze a Solana token's risk profile. Returns a 0-100 risk score based on holder concentration, liquidity, and distribution.

params: mintAddress

Parse a Solana transaction into human-readable format. Returns type, transfers, swaps, fees, and a plain-English description.

params: signature
whale_alert $0.01

Scan a wallet's recent transaction history for large movements. Returns whale-sized transfers and token movements.

params: walletAddress, minSolAmount?
dex_liquidity $0.002

Check DEX liquidity depth for a Solana token. Returns pool info, TVL estimates, and a liquidity rating (DEEP/MODERATE/SHALLOW/NONE).

params: mintAddress
token_holders $0.005

Get full holder list for a Solana token with concentration analysis. Returns top holders, balances, % of supply, and distribution metrics.

params: mintAddress, limit?
wallet_pnl $0.05

Calculate realized and unrealized PnL for a Solana wallet's token trades. Analyzes swap history to compute profit/loss per token in SOL.

params: walletAddress

Analyze a wallet's recent swap activity for copy trading. Returns active positions, buy/sell patterns, entry prices, and trading frequency.

params: walletAddress
web_scrape $0.005

Scrape any webpage and return clean text content. Strips HTML, scripts, and navigation. Returns the main content as readable text.

params: url
crypto_price $0.001

Get current price, market cap, volume, and 24h/7d change for any cryptocurrency. Supports search by name, symbol, or CoinGecko ID.

params: query
weather $0.001

Get current weather and 7-day forecast for any location by latitude/longitude. Returns temperature, humidity, wind, precipitation, and conditions.

params: latitude, longitude, location?

Search Google News for current headlines on any topic. Returns titles, sources, links, dates, and snippets.

params: query
compute_math $0.0005

Evaluate mathematical expressions. Supports arithmetic, algebra, unit conversions, trigonometry, matrices, and more.

params: expression
swap_quote $0.001

Get a Jupiter swap quote for any Solana token pair. Returns output amount, price impact, route, and fees. Essential before executing any trade.

params: inputMint, outputMint, amount, slippageBps?
priority_fee $0.0005

Get current Solana priority fee estimates. Returns low/medium/high/very_high fee levels in microLamports with SOL cost estimates. Call before every transaction.

params: none

Get SOL balance and all token balances for a Solana wallet. Lightweight check — use before transactions to verify sufficient funds.

params: walletAddress
pair_data $0.001

Get full DEXScreener stats for a token: price, 5m/1h/6h/24h volume, buy/sell counts, liquidity, market cap, and price changes. Returns the highest-volume pair.

params: tokenAddress
new_pairs $0.002

Get newly created token pairs on Solana. Shows the latest launches with price, volume, liquidity, and age in minutes. Essential for meme coin discovery.

params: none

Check if a Solana token is safe to trade. Returns rug pull detection, honeypot flags, freeze/mint authority, insider networks, transfer fees, and a risk score via RugCheck.

params: mintAddress

Get token metadata: name, symbol, decimals, supply, mint/freeze authority, mutability, and image. Lightweight call — use before any new token interaction.

params: mintAddress

Track which wallets are accumulating or dumping a token based on recent transfer activity. Returns top movers with net flow direction and a bullish/bearish/neutral sentiment signal.

params: mintAddress
top_traders $0.01

Find the most active and profitable traders of a specific token. Returns wallet addresses, buy/sell volumes, estimated PnL in SOL, and trader type classification.

params: mintAddress
yield_rates $0.002

Get current DeFi yield rates (APY) across Solana protocols. Returns top pools sorted by TVL from Marinade, Jito, Raydium, Orca, and more via DeFiLlama.

params: chain?
volume_alert $0.002

Find Solana tokens with unusual volume spikes right now. Returns tokens where recent 1h volume is disproportionately high vs 24h average — early signal for pumps.

params: none
gas_tracker $0.0005

Solana network congestion monitor. Returns current fee percentiles, congestion level (LOW/MODERATE/HIGH/VERY_HIGH), and a plain-English recommendation.

params: none

Get current odds for a prediction market. Search by market slug, ID, or natural language query like 'bitcoin 100k' or 'fed rate cut'. Returns probabilities, volume, liquidity, and outcome prices.

params: query

Find prediction markets with the biggest odds changes. Returns markets where probabilities shifted the most in a given timeframe — early signal for breaking news or sentiment shifts.

params: timeframe?, direction?, min_volume?, limit?, category?

Get probability/price history for a prediction market over time. Returns data points, high/low, and trend direction. Use for charting and analysis.

params: market, timeframe?

Aggregate sentiment across all prediction markets related to a topic. Searches Polymarket, analyzes probabilities, and returns a 0-100 sentiment score with bullish/bearish label.

params: topic, limit?

List all Drift Protocol BET prediction markets on Solana. Returns market symbols, implied probabilities, open interest, volume, and status (active/settlement/delisted). These are on-chain perpetual markets priced 0–1 USDC representing event probabilities.

params: none

Get detailed info for a specific Drift BET prediction market. Returns oracle price, mark price, 24h change, open interest, fees, funding rate, and recent fill history. Use symbol like 'TRUMP-WIN-2024-BET' or just 'TRUMP-WIN-2024'.

params: symbol

Get historical price/probability data for a Drift BET market. Returns OHLCV candles with implied probability percentages and trend direction. Use for charting and analysis.

params: symbol, timeframe?

Get open Drift BET prediction market positions from your configured Drift Gateway. Returns all active positions with entry price, current implied probability, unrealized PnL, and direction (long=YES, short=NO). Requires DRIFT_GATEWAY_URL to be set.

params: none

Place a bet on a Drift BET prediction market via your configured Drift Gateway. Long = betting YES, short = betting NO. Price is the implied probability (0.0–1.0). Requires DRIFT_GATEWAY_URL to be set and a funded Drift account.

params: symbol, direction, amountUsdc, limitPrice, orderType?

Close an open Drift BET prediction market position via your configured Drift Gateway. Submits a reduce-only market order to exit at the best available price. Requires DRIFT_GATEWAY_URL to be set.

params: symbol, amountUsdc?
drift_status $0.001

Check health of Drift Protocol APIs. Pings the Drift Data API and (if configured) your Drift Gateway. Returns latency, status (ok/error/not_configured), and an overall health verdict (healthy/degraded/down). Useful before placing bets or querying positions.

params: none

Score the security risk of software dependencies before using them. Checks each package against OSV.dev (Google's vulnerability database) and deps.dev for metadata. Returns per-package CVE counts, max severity, abandonment signals, and a hallucination check — HALLUCINATED means the package was not found and may be an AI-invented name or typosquat. Supports npm, pypi, go, maven, cargo, and nuget. Accepts up to 20 packages per call.

params: packages

Aggregate social sentiment for any crypto token or topic. Returns an overall 0-100 bullish score, per-source breakdown (market, community, social), mention volume, and confidence level. Sources: Alternative.me Fear & Greed (market), CoinGecko community votes, and StockGeist social media analysis (when STOCKGEIST_API_KEY is configured).

params: token
lending_rates $0.005

Compare lending and borrowing rates across Solana DeFi protocols (Kamino, MarginFi, Drift, Solend, Save, Mango). Returns supply APY, borrow APY, utilization rates, reward APY, and per-asset summaries showing the best rates. Filter by asset (USDC, SOL, mSOL, etc.) or protocol.

params: asset?, protocol?
smart_money $0.05

Analyze any Solana wallet's trading intelligence. Scores wallets 0-100 as Smart Money based on swap history: win rate, profit factor, early-entry ability, consistency, and diversification. Returns per-token trade stats, realized PnL in SOL, best/worst trades, and a human-readable label (Smart Money / Above Average / Average / Below Average). Use to evaluate copy-trade targets, track whale wallets, or assess counterparty skill.

params: walletAddress

Cross-platform prediction market search. Queries Polymarket, Kalshi, and Drift BET in parallel and returns unified results sorted by volume. Finds the same event across platforms to compare odds and spot arbitrage opportunities. Returns probabilities, volume, liquidity, and cross-platform matches with probability spreads.

params: query, limit?

Scan DeFi yields across L2 chains (Arbitrum, Optimism, Base, Polygon, zkSync, Linea, Scroll, Blast). Returns top pools sorted by APY with TVL, protocol, and per-chain summaries. Uses DeFi Llama data.

params: chain?, minTvl?, limit?

Compare gas costs across 8 L2 chains in real time. Returns gas price in Gwei, estimated swap cost in USD, cheapest/most expensive chain, and a recommendation. Queries all L2 RPCs in parallel.

params: none

Monitor Solana lending pools approaching liquidation. Tracks utilization rates across Kamino, MarginFi, Drift, Solend, Save, and Mango. Returns risk levels (CRITICAL/HIGH/MEDIUM/LOW), market stress indicator, and per-protocol summaries.

params: protocol?, riskLevel?, asset?
mev_detection $0.005

Detect MEV activity on Solana. In 'landscape' mode: returns current Jito tip floor, MEV activity level, and protection recommendations. In 'analyze' mode: checks if a specific transaction was part of a Jito bundle with tip detection and risk assessment.

params: transaction?, mode?

Find prediction market arbitrage opportunities across Polymarket, Kalshi, and Drift BET. Compares odds for the same event across platforms, calculates probability spreads, and flags actionable opportunities (>3% spread). Sorted by biggest spread first.

params: query?, minSpreadPct?, limit?

Track prediction market events and resolutions across Polymarket, Kalshi, and Drift BET. 'upcoming' mode: markets closing soonest with current odds. 'resolved' mode: recently settled markets with outcomes. Cross-platform coverage.

params: mode?, query?, timeframeDays?, limit?

Find the optimal cross-chain bridge route using LI.FI. Compare fees, speed, and output across bridges for any chain pair. Supports ETH, USDC, and custom tokens across Ethereum, Arbitrum, Optimism, Base, Polygon, zkSync, and more. Use toChain='scan' to compare all L2 destinations.

params: fromChain, toChain, token?, amount?

Scan code for leaked secrets, API keys, tokens, and credentials. Detects 16+ secret types including AWS keys, GitHub tokens, Stripe keys, private keys, JWTs, database URLs, and high-entropy strings. Returns redacted previews with severity levels and rotation recommendations. No external API — pure regex pattern matching.

params: code, filename?
solana_tvl $0.005

Solana ecosystem TVL analytics via DeFi Llama. Returns total TVL, top protocols ranked by TVL, category breakdown (DEX, Lending, Liquid Staking, etc.), 7-day trend, and Solana's market dominance as % of total DeFi. Filter by category for focused analysis.

params: category?, limit?, includeHistory?
lst_yields $0.005

Compare Solana Liquid Staking Token (LST) yields. Covers mSOL, jitoSOL, bSOL, INF, jupSOL, and 15+ LSTs across Marinade, Jito, Sanctum, BlazeStake, and more. Returns APY, TVL, best yields by TVL tier, and ecosystem average. Data from DeFi Llama.

params: minTvl?, sortBy?, limit?

Crypto Fear & Greed composite index. Aggregates Alternative.me index with CoinGecko market signals (market cap change, volume ratio, BTC dominance). Returns 0-100 score, classification (Extreme Fear to Extreme Greed), 7-day trend, historical comparison, and actionable signal summary.

params: includeHistory?

Cross-exchange funding rate arbitrage detector. Scans Binance, Bybit, OKX, and Hyperliquid perp markets in real time to find funding rate spreads. Returns ranked arbitrage opportunities with annualized yield, profit estimates, risk notes, and direction (which exchange to long/short). Use for delta-neutral carry trade discovery.

params: symbols?, minSpreadBps?, limit?