FalsifyLab/falsifylab-alpha-mcp

**MCP data layer for AI-assisted market research.** 13 live finance tools that drop into Claude Code, Cursor, Cline, Windsurf, or any MCP-compatible client. Free tier requires no signup.
> Not a signal service. Not investment advice. Public market data with light enrichment for AI agents. Backtest before acting.
Two ways to use it
**Option 1: hosted MCP (zero install).** Point your agent at the hosted endpoint, no Python needed.
Free tier auto-applies. OAuth 2.1 + PKCE flow for paid plan via Whop. Streamable HTTP transport. Full OpenAPI 3.1 spec at https://docs.falsifylab.com/openapi.html.
**Option 2: stdio (this package).**
Zero runtime dependencies (Python stdlib only). Then wire to your agent. see client setup.
What it does
When the user asks your AI agent things like:
- *"What insider clusters are forming today?"*
- *"Show me Hyperliquid vaults with sharp Sharpe and Use macro_tape. Show me SPX, VIX, BTC, ETH with 1d and 5d returns.
If the agent returns numbers, you're live.
Working agent prompts
Copy-paste these. They work on first run.
**Daily macro brief:**
**Insider + 8-K stacker:**
**Confluence scan with bear case:**
8 more recipes at falsifylab.com/cookbook.
Pricing
| Tier | Price | What |
|------|-------|------|
| Free | $0 | 24h cached, 10 results/query, no signup, 60 req/hr |
| Pro | $19/mo | Real-time (5min), 100 results/query, 90d history, no rate limit |
| Pro Plus | $49/mo | 1-min refresh, email + Slack alerts, 365d on equity feeds, webhooks |
| Teams | $199/mo | 5 seats, 50k req/day, priority support |
Launch promo EARLY50: 50% off first 3 months, capped 25 redemptions. Get a key at falsifylab.com/pro.
Live demo
Public agent calling these tools every 15 minutes: falsifylab.com/demo. Same MCP server you'd install. Real numbers, no curation.
Why this exists
Built it because the author hand-scraped SEC EDGAR and DefiLlama at 6am every morning to feed a fleet of trading bots. The bots that survived ate from this exact pipeline. Wrapped it as an MCP server so any agent can pull the same data.
The bot fleet receipts (alive + dead, P&L, drawdown) are public at falsifylab.com/vaults.
Transparency
- **What we do**: aggregate + lightly enrich public market data, expose via MCP
- **What we don't**: trade execution, brokerage, advisory, signal selling
- **Data sources**: SEC EDGAR (Form 4, 8-K), SoSoValue (ETF flows), DefiLlama (yield), Hyperliquid public API, Polymarket public API, Yahoo Finance (macro)
- **Privacy**: free-tier key issued by hash(IP+UA), not stored long-term. Request bodies never logged.
Telemetry
The local stdio server writes minimal per-tool telemetry JSONL rows to:
- /var/log/falsifylab/mcp_tool_calls.jsonl (override with FL_MCP_TOOL_CALL_LOG)
Each row includes only:
- ts, tool, args_keys (argument names only), has_api_key, key_hash (sha256 prefix), version
Never logged by this telemetry path:
- raw API keys
- argument values / request bodies
- IP address
- email / name / other user identifiers
To disable telemetry completely:
What works, what does not
Honest list. Updated every release.
What works today
- All 13 tools return live data inside agent calls under 1s p95.
- Free tier has zero signup friction. No API key needed for the cached path.