← cookbook · howto
Live US spot crypto ETF flow data for AI agents
Pull BTC + ETH spot ETF flows (daily net inflow, cumulative AUM, streak direction) into any MCP-compatible agent. Single tool call, no scraping.
install (60 seconds)
pip install falsifylab-alpha-mcp
then in your agent's MCP config:
{
"mcpServers": {
"falsifylab-alpha": {
"command": "python",
"args": ["-m", "falsifylab_alpha_mcp"]
}
}
}
the prompt that works
paste this into your agent:
use etf_flow_today and macro_tape. Compare BTC ETF inflow direction against BTC's 5d price action. If they diverge (ETF inflow but BTC down 5d), tell me — that's a leading institutional positioning signal.
why this works
Daily net inflows >$300M historically precede ~3-5% BTC up-moves in 1-2 weeks. SoSoValue is the raw source; we aggregate per-issuer and expose daily + cumulative + streak in one call.
the tool
etf_flow_today is one of 13 tools in FalsifyLab Alpha MCP (3 free, 10 Pro-only). Full schema at /.well-known/mcp/server-card.json. Tool descriptions at /install.
pricing
- Free tier: 3 tools, 5 results/query, no signup. Pro $19/mo: all 13 + real-time.
- Pro $19/mo: real-time, 100 results, 90d history. 7-day trial.
- Pro Plus $49/mo: 1min refresh, email + Slack alerts, webhooks.