FalsifyLab Alpha

falsifylab/falsifylab-alpha-mcp

Wires 13 live finance data tools into Claude, Cursor, Cline, or any MCP client. Pulls SEC Form 4 insider clusters, 8-K filings, DeFi yields from DefiLlama, Hyperliquid vault leaderboards, spot ETF flows, Polymarket whale positions, and a macro tape covering SPX through crypto. Free tier runs on 24-hour cache with no signup, Pro tier drops refresh to five minutes and lifts result caps. Ships as a zero-dependency Python package for stdio or you can point at their hosted MCP endpoint. Reach for it when you want your agent to ground trading ideas or market research in real-time public data instead of guessing from training cutoff.

tools: 10
auth: Secret needed
transport: STDIO
env var: 1
last updated: May 12, 2026

View on GitHub

Tools

10 tools

Public tool metadata for what this MCP can expose to an agent.

top_yield_farmsLatest 24h top DeFi yield farm picks with realistic APY (emissions stripped), risk notes, TVL, protocol. Sourced from FalsifyLab daily aggregator.3 params

Latest 24h top DeFi yield farm picks with realistic APY (emissions stripped), risk notes, TVL, protocol. Sourced from FalsifyLab daily aggregator.

Parameters* required

assetstring

filter by asset symbol (BTC, ETH, SOL, etc.)

limitinteger

max results (1-50)default: 10

min_apynumber

filter floor in pctdefault: 0

hl_vault_leaderboardHyperliquid vault leaderboard with NAV, 30d return, max drawdown, follower count, composite score.2 params

Hyperliquid vault leaderboard with NAV, 30d return, max drawdown, follower count, composite score.

Parameters* required

limitinteger

default: 10

sort_bystring

one of score · tvl · return_30d · followersdefault: score

insider_buy_clustersForm 4 insider buy clusters (3+ insiders bought same ticker in 24-48h). Bullish signal.2 params

Form 4 insider buy clusters (3+ insiders bought same ticker in 24-48h). Bullish signal.

Parameters* required

min_insidersinteger

default: 3

window_hoursinteger

default: 24

sec8k_material_todayMaterial SEC 8-K filings today filtered by item code: 2.02 (earnings), 5.02 (officer change), 2.01 (M&A), 3.02 (dilution), 4.02 (restatement), 3.01 (delisting).2 params

Material SEC 8-K filings today filtered by item code: 2.02 (earnings), 5.02 (officer change), 2.01 (M&A), 3.02 (dilution), 4.02 (restatement), 3.01 (delisting).

Parameters* required

itemsarray

item codes (e.g. ['2.02','5.02'])

tickerstring

filter by ticker symbol

macro_tapeLive US macro snapshot: SPX, NDX, RUT, VIX, UST 2y/10y, DXY, GOLD, WTI, BTC, ETH. Last price + 1d/5d % change.1 params

Live US macro snapshot: SPX, NDX, RUT, VIX, UST 2y/10y, DXY, GOLD, WTI, BTC, ETH. Last price + 1d/5d % change.

Parameters* required

symbolsarray

etf_flow_todayUS-listed spot crypto ETF aggregate flows today. BTC + ETH net flow, 5d streak, cumulative AUM.

US-listed spot crypto ETF aggregate flows today. BTC + ETH net flow, 5d streak, cumulative AUM.

No parameter schema in public metadata yet.

active_airdrop_farmsActive airdrop / points-farming opportunities detected from DefiLlama yield gaps. Includes realistic APY, TVL, capital required, confidence score.4 params

Active airdrop / points-farming opportunities detected from DefiLlama yield gaps. Includes realistic APY, TVL, capital required, confidence score.

Parameters* required

chainstring

filter (ethereum, base, arbitrum, etc.)

limitinteger

default: 10

min_apynumber

default: 0

min_tvl_usdnumber

default: 0

polymarket_whale_positionsTop Polymarket whale wallets and their current active positions sized >$10k. Copy-trade reference.1 params

Top Polymarket whale wallets and their current active positions sized >$10k. Copy-trade reference.

Parameters* required

min_position_usdinteger

default: 10000

confluence_todayCross-source confluence: tickers/assets where 2+ FalsifyLab signals align in the last 24h. Stacks insider Form 4 clusters, material 8-K filings, ETF flows, DeFi yields, airdrop activity, HL vault concentration. Higher signal_count = more conviction.3 params

Cross-source confluence: tickers/assets where 2+ FalsifyLab signals align in the last 24h. Stacks insider Form 4 clusters, material 8-K filings, ETF flows, DeFi yields, airdrop activity, HL vault concentration. Higher signal_count = more conviction.

Parameters* required

kindstring

one of equity · crypto · alldefault: all

limitinteger

default: 10

min_signalsinteger

default: 2

onchain_smart_walletsTop-scored on-chain wallets surfaced by FalsifyLab's live copy-trading bot's discovery + scoring engine. Composite score derived from 5 weighted sub-scores (profitability, consistency, risk, copyability, behavior_quality) with weights calibrated to actual copy-trade PnL correl...4 params

Top-scored on-chain wallets surfaced by FalsifyLab's live copy-trading bot's discovery + scoring engine. Composite score derived from 5 weighted sub-scores (profitability, consistency, risk, copyability, behavior_quality) with weights calibrated to actual copy-trade PnL correl...

Parameters* required

chainstring

filter by chain (solana, ethereum, etc.)

limitinteger

default: 10

min_scorenumber

composite score floor (0.0-1.0)default: 0.5

statusstring

filter by wallet statusone of MONITORED · CANDIDATE · ACTIVE · DEMOTED

Configuration

FL_API_KEYsecret

FalsifyLab API key. Free tier auto-issues on first call; Pro key from falsifylab.com/pro.

Readme

falsifylab-alpha-mcp

FalsifyLab Alpha: 13 live finance MCP tools for AI coding agents

View the full README on GitHub

Details

Repository: github.com/falsifylab/falsifylab-alpha-mcp
Website: falsifylab.com/pro
Category: Finance & Commerce
Package: falsifylab-alpha-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Finance & Commerce MCP servers

View all

Defillama Mcp Serverfriendlygeorge/defillama-mcp-serverMCP server for DeFi Llama — free DeFi TVL, yields, stablecoins, bridges, DEX, and fee data for AI...0stars

Fundchainfundchainteam/fundchain-mcpCrypto crowdfunding for AI agents. Create campaigns, accept ETH/USDC via x402 protocol.0stars

Defillama Mcpglebenjoy/defillama-mcpDefiLlama DeFi data: chain/protocol TVL, yields, stablecoins, token prices. No API key.0stars

Hyperliquid Info Mcpglebenjoy/hyperliquid-info-mcpHyperliquid perp & spot data: prices, funding, open interest, order book, positions. No API key.0stars

Hecher CRMgrowgeltsolutions/hecher-mcpHecher CRM for Chabad shluchim — donors, donations, activities, and reports across your Mosads0stars

Buda Mcpgtorreal/buda-mcpBuda.com market data: prices, spreads, OHLCV, order books, trades, and volume for CLP, COP, PEN.0stars