install in one command
13 live finance MCP tools for AI agents. Free: 3 tools, no signup. Pro $19/mo: all 13 + real-time.
pip install falsifylab-alpha-mcp
zero runtime dependencies. Python stdlib only. loading...
then wire to your agent
Claude Code
claude mcp add falsifylab-alpha \ -- python -m falsifylab_alpha_mcp
restart Claude Code after.
Cursor
drop into ~/.cursor/mcp.json or workspace root .mcp.json:
{
"mcpServers": {
"falsifylab-alpha": {
"command": "python",
"args": ["-m", "falsifylab_alpha_mcp"]
}
}
}
Cline
Settings → MCP Servers → Add Server. Paste same JSON as Cursor.
Windsurf
Settings → MCP. Same JSON config. Auto-indexed from Smithery soon.
add Pro key (optional, for real-time)
set FL_API_KEY in the agent's MCP env:
{
"mcpServers": {
"falsifylab-alpha": {
"command": "python",
"args": ["-m", "falsifylab_alpha_mcp"],
"env": {"FL_API_KEY": "fl_your_key_here"}
}
}
}
Free tier: 3 tools (top_yield_farms / hl_vault_leaderboard / macro_tape), 5 results/query, no signup. Pro $19/mo unlocks all 13 tools + real-time + 100 results + 90-day history. get Pro →
in your agent, ask:
use macro_tape — show me SPX, VIX, BTC, ETH with 1d and 5d returns
if the agent returns numbers, you're live.
the 13 tools (3 free / 10 Pro)
top_yield_farms— DeFi yields, emissions stripped, IL pricedhl_vault_leaderboard— Hyperliquid vaults by NAV, 30d, drawdowninsider_buy_clusters— SEC Form 4 cluster buys (3+ insiders 24h)sec8k_material_today— 8-K filings filtered by item codemacro_tape— SPX/NDX/VIX/UST/DXY/GOLD/WTI/BTC/ETH snapshotetf_flow_today— US spot BTC + ETH ETF aggregatesactive_airdrop_farms— DefiLlama yield-gap detectionpolymarket_whale_positions— top wallets + positionsconfluence_today— cross-source signal alignment (differentiator)onchain_smart_wallets— top scored Solana wallets from live copy-trading bot
next steps
pricing → try live demo → 8 working recipes → fork starter repo →
Research / data infrastructure. Not investment advice. Not a signal service. Backtest before acting.