momentum-mcp

<p align="center"> <h1 align="center">⚡ momentum-mcp</h1> <p align="center"> <strong>Give your AI agent a Bloomberg terminal.</strong> <br/> A Model Context Protocol server for quantitative trading analysis. </p> </p>

<p align="center"> <a href="#tools">Tools</a> • <a href="#quickstart">Quickstart</a> • <a href="#connect-your-client">Connect Your Client</a> • <a href="#tech-stack">Tech Stack</a> • <a href="#license">License</a> </p>

---

What Is This?

momentum-mcp turns any MCP-compatible AI assistant into a quantitative trading analyst. Instead of copy-pasting tickers into Yahoo Finance and screenshotting charts, your AI agent can:

• 🔍 Screen the entire market in seconds — find overbought stocks, unusual volume spikes, new 52-week highs
• 📊 Pull clean OHLCV data for any ticker, any timeframe — ready for analysis, no CSV wrangling
• 📈 Compute technical indicators — RSI, MACD with plain-English interpretation, not just raw numbers
• 🕯️ Generate professional candlestick charts — dark-themed with stacked EMA overlays (8/21/34/55/89), volume panels, publication-ready PNGs
• 📰 Aggregate financial news from multiple RSS sources in real-time
• 📄 Extract full article text from any URL — your agent reads the actual article, not just the headline

All of this happens through the Model Context Protocol, so your AI assistant calls these tools natively — no API keys, no REST endpoints, no configuration hell.

Example Chart Output

generate_chart("NVDA", period="6mo") → candlestick + volume + stacked EMAs:

Tools

Tool	What It Does
run_stock_screen	Scan for stocks by preset: most active, new highs/lows, overbought, oversold, high relative volume
get_historical_data	Fetch OHLCV candlestick data — any ticker, any period, any interval
analyze_technicals	Compute RSI(14) + MACD(12,26,9) and get a plain-English analysis summary
generate_chart	Render a candlestick chart with stacked EMA overlays (8/21/34/55/89) + volume → PNG + base64
fetch_ticker_news	Pull recent headlines from Yahoo Finance & Google News RSS feeds
extract_article_text	Extract the full article body from any URL (strips ads, nav, paywalls)

Quickstart

git clone https://github.com/mphinance/momentum-mcp.git
cd momentum-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Test that everything works:

python -c "from mcp_server.server import mcp; print('✓ Ready')"

Run the server:

python -m mcp_server.server

Connect Your Client

Claude Desktop

The most popular MCP client. Add to your claude_desktop_config.json (located at ~/Library/Application Support/Claude/ on macOS or %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "momentum": {
      "command": "python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/momentum-mcp",
      "env": {
        "VIRTUAL_ENV": "/absolute/path/to/momentum-mcp/.venv",
        "PATH": "/absolute/path/to/momentum-mcp/.venv/bin:$PATH"
      }
    }
  }
}

Restart Claude Desktop. You'll see the 🔨 tools icon — click it to verify all 6 tools are loaded.

---

Cursor

Add to .cursor/mcp.json in your project root (or global config at ~/.cursor/mcp.json):

{
  "mcpServers": {
    "momentum": {
      "command": "/absolute/path/to/momentum-mcp/.venv/bin/python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/momentum-mcp"
    }
  }
}

The tools will be available in Cursor's Agent mode. Ask it to "screen for overbought stocks" or "chart NVDA over the last 6 months."

---

VS Code + GitHub Copilot

MCP is generally available in GitHub Copilot (VS Code 1.86+). Add to your .vscode/mcp.json:

{
  "servers": {
    "momentum": {
      "command": "/absolute/path/to/momentum-mcp/.venv/bin/python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/momentum-mcp"
    }
  }
}

Enable Agent mode in the Copilot Chat panel — momentum tools will appear in the tool picker.

---

Windsurf

Add to your Windsurf MCP config at ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "momentum": {
      "command": "/absolute/path/to/momentum-mcp/.venv/bin/python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/momentum-mcp"
    }
  }
}

Cascade will automatically discover the tools. Use them in any Windsurf chat.

---

Cline (VS Code Extension)

Open Cline's MCP settings (gear icon → MCP Servers → "Edit MCP Settings") and add:

{
  "mcpServers": {
    "momentum": {
      "command": "/absolute/path/to/momentum-mcp/.venv/bin/python",
      "args": ["-m", "mcp_server.server"],
      "cwd": "/absolute/path/to/momentum-mcp"
    }
  }
}

Cline will list the tools in its server panel. Enable them and they're ready to use.

---

Claude Code (CLI)

Add the server directly from the terminal:

claude mcp add momentum \
  /absolute/path/to/momentum-mcp/.venv/bin/python \
  -m mcp_server.server \
  --cwd /absolute/path/to/momentum-mcp

Verify it's connected:

claude mcp list

---

Any Other MCP Client

momentum-mcp uses the stdio transport (the MCP default). Any client that supports stdio can connect by running:

/path/to/.venv/bin/python -m mcp_server.server

That's it. No HTTP server, no ports, no auth — just stdin/stdout.

Project Structure

momentum-mcp/
├── requirements.txt         # Pinned dependencies
├── README.md
└── mcp_server/
    ├── __init__.py
    ├── server.py            # FastMCP entry point — registers all tools
    ├── screener.py          # TradingView stock scanner (6 presets)
    ├── data.py              # yfinance OHLCV with async wrapper
    ├── technicals.py        # pandas-ta RSI(14) & MACD(12,26,9)
    ├── charts.py            # mplfinance candlestick + volume charts
    └── news.py              # feedparser RSS + trafilatura extraction

Tech Stack

Library	Role
FastMCP	MCP server framework (v3.x)
tradingview-screener	Stock screening via TradingView's API
yfinance	Yahoo Finance OHLCV data
pandas-ta	130+ technical indicators
mplfinance	Financial chart rendering
feedparser	RSS/Atom feed parsing
trafilatura	Web article text extraction

Example Prompts

Once connected, try asking your AI assistant:

"Screen the market for stocks with high relative volume today"

"Get me 6 months of daily data for NVDA and analyze the technicals"

"Generate a candlestick chart for AAPL over the past year"

"What's the latest news on TSLA? Pull the full text of the most interesting article."

"Find oversold stocks, then analyze the technicals on the top 3 results"

License

MIT — do whatever you want with it.