falsifylab-alpha-mcp 0.1.4

MCP data layer for AI-assisted market research: 9 finance tools for AI agents covering DeFi yield, Hyperliquid vaults, SEC Form 4 insider clusters, 8-K material filings, macro tape, US spot ETF flows, airdrop farms, Polymarket whales, plus confluence_today cross-source signal alignment. Free tier requires no signup. Pro $19/mo for real-time, 100 results, 90-day history.

falsifylab-alpha-mcp

MCP data layer for AI agents doing public-market research. Drops into Claude Code, Cursor, Cline, Windsurf, or any MCP-compatible client.

Tools (9 — 8 data feeds + 1 confluence)

• top_yield_farms — last 24h DeFi yield picks with realistic APY (emissions stripped)
• hl_vault_leaderboard — Hyperliquid vault leaderboard (NAV, 30d return, max DD, score)
• insider_buy_clusters — SEC Form 4 cluster buys (3+ insiders bought same ticker)
• sec8k_material_today — material 8-K filings filtered by item code
• macro_tape — SPX/NDX/VIX/UST yields/DXY/GOLD/WTI/BTC/ETH live snapshot
• etf_flow_today — US spot BTC + ETH ETF net flows
• active_airdrop_farms — DefiLlama yield-gap airdrop detection
• polymarket_whale_positions — top whale wallets + active positions
• confluence_today — cross-source signal alignment (the differentiator)

Not a signal service. Not investment advice. Public market data with light enrichment. Backtest before acting.

Install

pip install falsifylab-alpha-mcp

Claude Code config

claude mcp add falsifylab-alpha \
  --env FL_API_KEY=<your-key-from-falsifylab.com> \
  -- python -m falsifylab_alpha_mcp

Or in .mcp.json:

{
  "mcpServers": {
    "falsifylab-alpha": {
      "command": "python",
      "args": ["-m", "falsifylab_alpha_mcp"],
      "env": {"FL_API_KEY": "fl_xxx"}
    }
  }
}

Pricing

• Free (no API key): last-24h cached data, rate-limited
• Pro $19/mo (API key): real-time, 90-day history, all filters, no rate limit

Get a key at falsifylab.com/pro.

Source

• GitHub: https://github.com/FalsifyLab/falsifylab-alpha-mcp
• Issues: https://github.com/FalsifyLab/falsifylab-alpha-mcp/issues
• PyPI: https://pypi.org/project/falsifylab-alpha-mcp/

License

MIT