falsifylab-agent-starter

Drop-in starter for AI coding agents pre-wired with the FalsifyLab MCP server. 9 live finance tools, example prompts, free tier requires no signup.

Works with Claude Code, Cursor, Cline, Windsurf, or any MCP-compatible client.

What you get

• .mcp.json — ready-to-use Cursor/Windsurf config
• claude-code-setup.sh — one-line Claude Code install
• examples/ — 4 example agent prompts that grab real data on first run
• daily_research_agent.py — Python script your agent can run on a cron

Install (60 seconds)

Step 1 — install the MCP server

pip install falsifylab-alpha-mcp

Zero runtime dependencies (Python stdlib only).

Step 2 — wire it up

Claude Code:

bash claude-code-setup.sh

Or manually:

claude mcp add falsifylab-alpha -- python -m falsifylab_alpha_mcp

Cursor / Windsurf: copy .mcp.json to your workspace or ~/.cursor/mcp.json. Restart.

Cline: Settings → MCP Servers → Add Server → paste .mcp.json content.

Step 3 — test

In your agent, type:

Use the macro_tape tool. Show me SPX, VIX, BTC, and ETH with 1d and 5d returns.

If the agent returns numbers, you're live. The first call auto-issues a free tier-0 API key (no signup, no email).

The 9 tools

Tool	What it does
top_yield_farms	DeFi yields with emissions stripped, IL risk priced
hl_vault_leaderboard	Hyperliquid vault rankings (NAV, 30d, drawdown)
insider_buy_clusters	SEC Form 4 cluster buys (3+ insiders, 24h)
sec8k_material_today	Material 8-K filings filtered by item code
macro_tape	SPX/NDX/VIX/UST/DXY/GOLD/WTI/BTC/ETH snapshot
etf_flow_today	US spot BTC + ETH ETF aggregates
active_airdrop_farms	DefiLlama yield-gap airdrop detection
polymarket_whale_positions	Top wallets + active positions
confluence_today	Cross-source signal alignment (the differentiator)

Example prompts that work out of the box

See examples/agent_prompts.md for full list. Quick samples:

Find me 3 stablecoin yield farms on Arbitrum with >$5M TVL.

What insider clusters are forming today? Show top 3 by total purchase USD.

Run confluence_today (kind=equity) and tell me what's lighting up.

Build a Python script that calls insider_buy_clusters + sec8k_material_today
hourly and emails me when a ticker appears in both.

Pricing

Tier	Price	What
Free	$0	24h cached, 10 results/query, no signup
Pro	$19/mo	Real-time, 100 results, 90d history
Pro Plus	$49/mo	1min refresh, alerts (email + Slack), 365d on equity feeds
Teams	$199/mo	5 seats, 50k req/day, priority support

Launch promo EARLY50 — 50% off first 3 months on any paid tier. Capped 25 redemptions.

Get a key at falsifylab.com/pro.

Live proof

• falsifylab.com/demo — public agent reads 8 tools every 15min
• falsifylab.com/fleet — bot fleet receipts (alive, dead, P&L)

Why this exists

The author runs trading bots. Most die. The ones still alive eat from this exact pipeline.

The MCP server is the same data the surviving bots eat. The free tier is real, not a teaser.

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

Contributing

PRs welcome. If you build something useful with this starter:

1. Open an issue describing what
2. Add it to examples/
3. Submit PR

We star contributors back and may feature your work in the Substack.

Links

• MCP server: github.com/FalsifyLab/falsifylab-alpha-mcp
• PyPI: falsifylab-alpha-mcp
• Smithery: smithery.ai/servers/falsifylab/falsifylab-alpha-mcp
• Docs: github.com/FalsifyLab/falsifylab-alpha-mcp#readme
• Substack: falsifylab.substack.com

MIT license. Fork it, modify it, ship it.