# FalsifyLab Alpha

FalsifyLab Alpha adds 13 finance tools to your coding agent, all on public market data: DeFi yields, ETF flows, insider buys, Polymarket positions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 176 installs · ★ 1 repo stars
- Author: falsifylab
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FalsifyLab/falsifylab-alpha-mcp
- Updated: 2026-06-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/falsifylab-alpha

## What it does

The endpoint `https://falsifylab-alpha-mcp--falsifylab.run.tools` speaks HTTP, so nothing gets installed on your machine. Your agent picks up 13 tools: DeFi yields, Hyperliquid vaults, clusters of insider purchases from Form 4, material 8-K events, a macro snapshot, spot ETF flows, airdrop farms, Polymarket whale positions, Solana wallet rankings, token unlocks and Fed event windows.

The free tier needs no signup and works on the first call. Answers come from a 24-hour cache and stop at 10 rows per query. Pro at $19/mo cuts the lag to five minutes, allows 100 rows, adds 90 days of history and drops the request cap; sign-in runs over OAuth 2.1 with PKCE through Whop. A stdio build is also available as `pip install falsifylab-alpha-mcp` and uses only the Python standard library.

60 requests per hour is where the free tier ends. A loop over a few dozen tickers burns through that in one go.

## Requirements
- Remote server: `https://falsifylab-alpha-mcp--falsifylab.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http falsifylab-alpha-mcp https://falsifylab-alpha-mcp--falsifylab.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add falsifylab-alpha --url https://falsifylab-alpha-mcp--falsifylab.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "falsifylab-alpha": {
            "url": "https://falsifylab-alpha-mcp--falsifylab.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "falsifylab-alpha": {
            "type": "http",
            "url": "https://falsifylab-alpha-mcp--falsifylab.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http falsifylab-alpha https://falsifylab-alpha-mcp--falsifylab.run.tools
```

## When to use it
- pull DeFi yields with token emissions taken out
- scan Form 4 insider buying clusters for the day
- filter 8-K filings by material event codes
- check whether spot BTC ETF flows agree with price
- read the forward token unlock schedule

## Example prompts
- Use `macro_tape` and describe the market regime from SPX, VIX, BTC and ETH.
- Cross-check `insider_buy_clusters` against `sec8k_material_today` and list tickers that show up in both.
- Run `confluence_today` with `min_signals=2` and explain the strongest contrarian stack.

## Similar
- [Octagon](https://affpapa.org/en/nevibecode/mcp/octagon.md) — MCP server
- [IPOGrid Research](https://affpapa.org/en/nevibecode/mcp/ipogrid-research.md) — MCP server · 653 installs
- [equibles](https://affpapa.org/en/nevibecode/plugins/equibles-equibles.md) — plugin · ★ 1596 repo stars
- [alpha_vantage_mcp](https://affpapa.org/en/nevibecode/mcp/alpha-vantage-mcp.md) — MCP server · ★ 227 repo stars
- [linq-alpha](https://affpapa.org/en/nevibecode/plugins/linq-alpha.md) — plugin
- [Canli Markets](https://affpapa.org/en/nevibecode/mcp/canli-markets.md) — MCP server · ★ 6 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
