FalsifyLab Alpha MCP server

falsifylab-alpha-mcp

<!-- mcp-name: io.github.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.

{
  "mcpServers": {
    "falsifylab-alpha": {
      "url": "https://mcp.falsifylab.com/"
    }
  }
}

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).

pip install falsifylab-alpha-mcp

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 <10% drawdown"
• "Are BTC ETF flows confirming or diverging from price action?"
• "What's in the macro tape right now?"
• "Find Polymarket whales with 60%+ win rate"

...the agent calls one of 13 tools and grounds its answer in real-time numbers from public-market data — instead of speculating from training-data knowledge.

The 13 tools

All tools have full JSON schemas exposed at /.well-known/mcp/server-card.json.

Client setup

Claude Code

Shortened. The full README is on GitHub.