cookbook — working agent recipes
copy-paste these into Claude Code / Cursor / Cline / any MCP client. 13 tools (3 free / 10 Pro $19/mo), no signup for free tier.
install once: pip install falsifylab-alpha-mcp
then in your MCP client, paste prompts below. agent reads tools + writes the workflow.
recipes
1. daily macro regime brief
3-sentence regime call grounded in real numbers. ~5 sec.
Use macro_tape. Tell me the macro regime in 3 sentences. Cite specific numbers — last price, 1d return, 5d return. Then list 2 tickers from sec8k_material_today that might benefit from this regime. Be terse.
2. insider cluster + 8-K aligner
Find tickers with both buy clusters + material filings in 24h.
Run insider_buy_clusters (min_insiders=3) and sec8k_material_today (items=["2.02","8.01","5.02"]). Find any ticker that appears in both within the last 24h. For each match, summarize what the insiders bought and what the 8-K said. End with the bear case in one sentence.
3. confluence scan with bear case
9th-tool cross-source scan + skeptical framing.
Use confluence_today with min_signals=2. For each asset/ticker, explain in 2 sentences why these signals stacking is meaningful. Skip obvious noise (DeFi LP pools with stablecoins). Highlight the most contrarian stack and what would invalidate it.
4. HL vault risk-adjusted picker
Pick 2 copyable vaults with reasonable Sharpe + drawdown.
Use hl_vault_leaderboard with sort_by=score, limit=5. For each, flag any vault with high return but high drawdown — that's noise, not signal. Pick 2 you'd actually copy-trade and explain why composite_score isn't enough to trust them blindly.
5. yield audit (emissions stripped)
Sanity-filtered DeFi yield picks.
Use top_yield_farms with min_apy=15. Strip any pool where realistic_apy above 500% (probably broken data) or TVL below $1M (illiquid). For survivors, rank by realistic_apy / sqrt(TVL) as crowded-vs-uncrowded proxy. Recommend 3 with reasonable APY-to-risk profile.
6. ETF flow vs price divergence
Detect institutional positioning vs price.
Use etf_flow_today and macro_tape. Check if BTC ETF inflow direction matches BTC's 5d return direction. If they diverge (ETF inflow but BTC down 5d), that's a leading signal. Tell me which way and what it might mean for 1-2 week horizon.
7. airdrop yield-gap hunter
Farms where base yield covers wait time.
Use active_airdrop_farms with min_tvl_usd=5000000 and min_apy=10. gap_apy is what you earn while waiting; the airdrop itself is bonus, not promised. Pick 3 with cleanest setup — positive gap_apy means the farm pays you to wait.
8. polymarket whale copy-trade
Top wallets weighted by conviction.
Use polymarket_whale_positions with min_position_usd=50000. For each whale, calculate win_rate × position_size_USD as conviction score. List top 3 by conviction and tell me which crypto-related markets they're betting on. Don't blindly copy — assess each market thesis first.
build your own bot
each recipe is a starting point. for production use, combine multiple recipes into a Python script that runs on a cron. example template:
import urllib.request, json
def fetch(path):
req = urllib.request.Request(f"https://falsifylab.com{path}")
with urllib.request.urlopen(req, timeout=20) as r:
return json.loads(r.read())
# combine confluence + macro for daily research
conf = fetch("/api/confluence?min_signals=2")
macro = fetch("/api/macro")
# your logic here
print(conf, macro)
or fork the agent starter repo — pre-wired Cline/Cursor config + 12 example prompts.
get more
Pro $19/mo — real-time + 100 results + 90d history → try live demo → earn 30-40% recurring →