# FalsifyLab Alpha

9 live finance MCP tools for AI coding agents: DeFi yield farms (emissions-stripped real APY), Hyperliquid vault leaderboard, SEC Form 4 insider buy clusters, 8-K material filings, macro tape (SPX/ND…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add falsifylab/falsifylab-alpha-mcp

# Browse available tools
npx -y smithery tool list falsifylab/falsifylab-alpha-mcp

# Get full schema for a tool
npx -y smithery tool get falsifylab/falsifylab-alpha-mcp top_yield_farms

# Call a tool
npx -y smithery tool call falsifylab/falsifylab-alpha-mcp top_yield_farms '{}'
```

## Direct MCP Connection

Endpoint: `https://falsifylab-alpha-mcp--falsifylab.run.tools`

**Optional config:**
- `FL_API_KEY` (query) — Optional. Skip for free tier (server auto-issues key on first call, 24h cached, 10 results/query). Pro keys from falsifylab.com/pro unlock real-time + 100 results + 90-day history.

## Tools (9)

- `top_yield_farms` — Latest 24h top DeFi yield farm picks with realistic APY (emissions stripped), risk notes, TVL, protocol. Sourced from F…
- `hl_vault_leaderboard` — Hyperliquid vault leaderboard with NAV, 30d return, max drawdown, follower count, composite score.
- `insider_buy_clusters` — Form 4 insider buy clusters (3+ insiders bought same ticker in 24-48h). Bullish signal.
- `sec8k_material_today` — Material SEC 8-K filings today filtered by item code: 2.02 (earnings), 5.02 (officer change), 2.01 (M&A), 3.02 (dilutio…
- `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, 5d streak, cumulative AUM.
- `active_airdrop_farms` — Active airdrop / points-farming opportunities detected from DefiLlama yield gaps. Includes realistic APY, TVL, capital …
- `polymarket_whale_positions` — Top Polymarket whale wallets and their current active positions sized >$10k. Copy-trade reference.
- `confluence_today` — Cross-source confluence: tickers/assets where 2+ FalsifyLab signals align in the last 24h. Stacks insider Form 4 cluste…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get falsifylab/falsifylab-alpha-mcp <tool-name>
```
