OpenAlpha — Claude Code MCP server: what it does, how to install
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.
MIT ★ 8 updated 2026-11-17
claude mcp add --env OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> --transport stdio openalpha -- npx -y openalpha-mcpWhat OpenAlpha 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.
What it helps with
- 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 for the agent
- Evaluate AAPL and provide entry levels with risk limits
- /suggest FPT
- Show the bear case and invalidation criteria for gold
How to install OpenAlpha
Platform CLI
claude mcp add --env OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> --transport stdio openalpha -- npx -y openalpha-mcpReplace <…> with your own values
Platform CLI
codex mcp add openalpha --env OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> -- npx -y openalpha-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"openalpha": {
"command": "npx",
"args": [
"-y",
"openalpha-mcp"
],
"env": {
"OPENALPHA_INSTALL_DIR": "<OPENALPHA_INSTALL_DIR>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"openalpha": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"openalpha-mcp"
],
"env": {
"OPENALPHA_INSTALL_DIR": "<OPENALPHA_INSTALL_DIR>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> openalpha npx -y openalpha-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenAlpha
How to install OpenAlpha in Claude Code?
Run claude mcp add openalpha -- npx -y openalpha-mcp. For directory-specific configurations, run claude mcp add --env OPENALPHA_INSTALL_DIR=<OPENALPHA_INSTALL_DIR> --transport stdio openalpha -- npx -y openalpha-mcp.
What does OpenAlpha do?
It acts as an investment research agent across equities, gold, and crypto markets. The tool evaluates trade setups, computes risk metrics, and outlines conditions that invalidate an idea.
What is required to run OpenAlpha?
You need a machine running macOS, Linux, or Windows 10/11. In addition, you must supply an OpenRouter API key or authenticate with a paid ChatGPT account.