# FalsifyLab

> Live finance MCP tools for AI agents. 13 endpoints: DeFi yield (emissions stripped, IL priced), Hyperliquid vault leaderboard, SEC Form 4 insider clusters, 8-K material filings, macro tape, ETF flows, airdrops, Polymarket whales. Free tier requires no signup. Pro tier $19/mo.

Package: `pip install falsifylab-alpha-mcp` — stdio MCP server, Python stdlib only, zero runtime deps.

## Install + integrate

- [Install guide for any MCP client](https://github.com/FalsifyLab/falsifylab-alpha-mcp#install): pip + one config line for Claude Code / Cursor / Cline / Windsurf
- [Autonomous install spec (Cline-style)](https://raw.githubusercontent.com/FalsifyLab/falsifylab-alpha-mcp/main/llms-install.md): for agents installing without human help
- [MCP server card with all 10 tool schemas](https://falsifylab.com/.well-known/mcp/server-card.json): JSON-RPC-shaped tool definitions
- [PyPI package](https://pypi.org/project/falsifylab-alpha-mcp/): version + release notes

## Live proof

- [Live demo agent (HTML)](https://falsifylab.com/demo): public agent reading our live feeds every 15min, writes 80-120w observation. Refreshes every 15min.
- [Live demo snapshot (JSON)](https://falsifylab.com/demo.json): same data, agent-readable
- [Bot fleet receipts](https://falsifylab.com/fleet): public table of every bot we ever shipped — alive, dead, trades, return, drawdown. No curation. Refreshes daily.
- [Cross-source confluence](https://falsifylab.com/api/confluence): tickers/assets where 2+ FalsifyLab signals align in 24h. Our 9th tool, the differentiator.
- [Comparison vs Token Terminal / Nansen / Dune / Arkham / Quiver](https://falsifylab.com/vs): honest table of who covers what.
- [Cookbook — 8 working agent recipes](https://falsifylab.com/cookbook): copy-paste prompts that work on first run. Macro brief, insider+8K aligner, confluence scan with bear case, HL vault picker, yield audit, ETF flow divergence, airdrop hunter, polymarket whale copy.
- [Affiliate program](https://falsifylab.com/affiliates): 30-40% recurring (USDC) for partners who refer developers. Performance-only, no upfront cost, public-market research framing required.

## Direct REST API (free tier, no auth)

- [Macro tape snapshot](https://falsifylab.com/api/macro): SPX/VIX/UST/DXY/GOLD/WTI/BTC/ETH with 1d/5d returns
- [Top DeFi yields](https://falsifylab.com/api/yield/top): emissions stripped, IL priced
- [ETF flows today](https://falsifylab.com/api/etf_flow): US spot BTC + ETH ETFs
- [SEC 8-K material today](https://falsifylab.com/api/sec8k/today): filtered by item code
- [SEC Form 4 clusters](https://falsifylab.com/api/form4/clusters): 3+ insiders same ticker 24h
- [Active airdrop farms](https://falsifylab.com/api/airdrops): DefiLlama yield-gap
- [Hyperliquid vault leaderboard](https://falsifylab.com/api/hl_vaults): NAV, 30d return, drawdown

## Pricing

- Free: 3 tools (top_yield_farms / hl_vault_leaderboard / macro_tape) at 5 results/query, rate-limited 60/hr, no signup. Pro $19/mo: all 13 tools, 100 results, real-time.
- Pro $19/mo: real-time (5min), 100 results, 90d history on all 9 data feeds, no rate limit. 7-day trial.
- Pro Plus $49/mo: 1min refresh, 1000 results, email + Slack + confluence alerts, 365d on equity + macro + ETF feeds.
- Teams $199/mo: 5 seats, 50k req/day, 5 webhooks, priority support.
- Launch promo `EARLY50`: 50% off first 3mo, capped 25 subs across all tiers.

[Get Pro](https://falsifylab.com/pro)

## Project context

- [GitHub repository](https://github.com/FalsifyLab/falsifylab-alpha-mcp): source, issues, releases
- [Smithery listing](https://smithery.ai/servers/falsifylab/falsifylab-alpha-mcp): discovery + install for Claude/ChatGPT/Windsurf
- [mcp.so listing](https://mcp.so/server/falsifylab-alpha): alternative directory
- [Substack newsletter](https://falsifylab.substack.com): weekly portfolio memo + bot killboard

## Optional

- [Privacy policy](https://falsifylab.com/privacy)
- [Terms of service](https://falsifylab.com/tos)
- [Killbot (separate forensics SaaS)](https://falsifylab.com/killbot)
- [Hyperliquid vault tracker (separate page)](https://falsifylab.com/vaults)