# OpenAlpha

OpenAlpha is a Claude Code MCP server that generates structured investment trade setups for equities, gold, and crypto. It details entry points, stop-losses, and portfolio sizing.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: alex2loop
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alex2loop/openalpha
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — warning: a command downloads a script from raw.githubusercontent.com and runs it right away; a command downloads a script and runs it right away; a PowerShell command downloads a script from raw.githubusercontent.com and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/openalpha

## What it does

The server orchestrates a multi-perspective debate across dedicated roles: bull, bear, risk manager, synthesizer, and fact-checker. Deterministic code calculates entry levels, stop-losses, and sizing targets, while language models lay out the thesis and counter-thesis for each asset.

Portfolio weights are shared with the agent, but raw account balances, cash totals, and trade prices stay hidden on the host machine. Every suggested action remains advisory; nothing routes to a broker without explicit confirmation.

Operation requires macOS, Linux, or Windows 10/11 alongside AI access via an OpenRouter API key or a paid ChatGPT subscription.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OPENALPHA_INSTALL_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> --transport stdio openalpha -- npx -y openalpha-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add openalpha --env OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> -- npx -y openalpha-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openalpha": {
            "command": "npx",
            "args": [
                "-y",
                "openalpha-mcp"
            ],
            "env": {
                "OPENALPHA_INSTALL_DIR": "<OPENALPHA_INSTALL_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "openalpha": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "openalpha-mcp"
            ],
            "env": {
                "OPENALPHA_INSTALL_DIR": "<OPENALPHA_INSTALL_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> openalpha npx -y openalpha-mcp
```
Replace <…> with your own values

## When to use it
- generate structured trade entries, stops, and take-profit targets
- surface bull and bear arguments before taking a position
- calculate position sizes based on portfolio allocation limits
- log and evaluate past trade predictions against market outcomes

## Example prompts
- Evaluate AAPL and provide entry levels with risk limits
- /suggest FPT
- Show the bear case and invalidation criteria for gold

## Similar
- [Stock Screener](https://affpapa.org/en/nevibecode/mcp/stock-screener.md) — MCP server · ★ 424 repo stars
- [portfolio-watcher](https://affpapa.org/en/nevibecode/skills/portfolio-watcher.md) — skill · 120 installs
- [equity-research](https://affpapa.org/en/nevibecode/skills/equity-research.md) — skill · 3400 installs
- [kanchi-dividend-sop](https://affpapa.org/en/nevibecode/skills/kanchi-dividend-sop.md) — skill · 3500 installs
- [us-value-investing](https://affpapa.org/en/nevibecode/skills/us-value-investing.md) — skill · 729 installs
- [llmquant-equities](https://affpapa.org/en/nevibecode/skills/llmquant-equities.md) — skill · 544 installs

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