API Reference

29 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