tool reference
13 MCP tools (3 free / 10 Pro $19/mo). Click any tool to see signature, returns, example prompt, and design rationale.
install once: pip install falsifylab-alpha-mcp
or browse the cookbook for 8 working agent recipes.
top_yield_farms
DeFi yield farms ranked by realistic APY. Strips emissions inflation. Prices impermanent loss into the score.
hl_vault_leaderboard
Hyperliquid vault leaderboard. NAV, 30d return, max drawdown, composite score, follower count.
insider_buy_clusters
SEC Form 4 cluster buys. 3+ insiders bought the same ticker within 24h. Filters to open-market purchases only (P code), excludes awards/gifts.
sec8k_material_today
Material SEC 8-K filings today, filtered by item code (2.02 earnings, 5.02 officer change, 8.01 material event, 2.01 M&A, 3.02 dilution, etc.).
macro_tape
Live US macro snapshot. SPX, NDX, RUT, VIX, UST 2y/10y, DXY, GOLD, WTI, BTC, ETH. Last price + 1d/5d % change.
etf_flow_today
US-listed spot crypto ETF aggregate flows today. BTC + ETH net flow USD, 5-day streak, cumulative AUM. Source: SoSoValue.
active_airdrop_farms
Active airdrop / points-farming opportunities. Detected from DefiLlama yield gaps where reported APY exceeds base+rewards (likely points program).
polymarket_whale_positions
Top Polymarket whale wallets and their current active positions sized over $10k. Includes composite score (0.40 profit + 0.30 win-rate + 0.15 activity + 0.15 bet sizing).
confluence_today
Cross-source signal alignment. Tickers and assets where 2+ FalsifyLab signals stack in the last 24h.
onchain_smart_wallets
Top-scored on-chain wallets surfaced by FalsifyLab's live Solana copy-trading bot. 5 sub-scores: profitability, consistency, risk, copyability, behavior_quality.