Skip to main content
Glama
portfolio-signals-mcp

portfolio-signals-mcp

Portfolio Signals MCP

PyPI Python License: MIT

An MCP server that gives any AI coding agent (Claude Code, Cursor, Claude Desktop, etc.) real-time stock quotes and computed technical-analysis signals — RSI, MACD crossovers, golden/death crosses, and whole-portfolio weekly digests. Indicators are calculated in code, not by the LLM, so the numbers are right.

Data source: Yahoo Finance via yfinance — free, no API key required.

mcp-name: io.github.KhizarShabir1/portfolio-signals

Tools

Tool

What it does

get_quote(ticker)

Price, day change, volume, 52-week range

get_technical_signals(ticker)

RSI(14) with overbought/oversold zone, MACD(12,26,9) vs signal line, SMA 50/200 golden/death cross

compare_tickers(tickers, period)

Ranked total returns over 1mo–5y

weekly_digest(tickers)

Whole-portfolio report: 1w/1mo returns, RSI, MACD position, tickers outside RSI 30–70

Design principle: tools return measurements and standard threshold classifications (RSI 70/30 zones, golden/death cross, MACD vs signal line) — never directional opinions or narrative summaries. Interpretation is the agent's job; determinism is the server's.

Batch tools degrade per ticker: if one symbol fails, compare_tickers and weekly_digest still return the rest, and the failed entry carries error and error_type. TickerNotFoundError means a bad symbol (don't retry); other types, such as ConnectionError, are transient (retry).

Related MCP server: StockQuotes MCP

Quick start

No install needed if you have uv:

uvx portfolio-signals-mcp

Claude Code

claude mcp add portfolio-signals -- uvx portfolio-signals-mcp

Then ask Claude things like:

  • "What's the RSI and MACD on NVDA right now?"

  • "Compare AAPL, MSFT and VOO over 6 months."

  • "Give me a weekly digest for my portfolio: AAPL, NVDA, VOO, TSLA."

Cursor

Settings → Tools & MCP → Add a Custom MCP Server:

{
  "mcpServers": {
    "portfolio-signals": {
      "command": "uvx",
      "args": ["portfolio-signals-mcp"]
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "portfolio-signals": {
      "command": "uvx",
      "args": ["portfolio-signals-mcp"]
    }
  }
}

From source

git clone https://github.com/KhizarShabir1/portfolio-signals-mcp
cd portfolio-signals-mcp
pip install -e .
portfolio-signals-mcp           # stdio
portfolio-signals-mcp --http    # streamable HTTP on :8000 (PORT env to change)

Tests

pip install -e ".[test]"
pytest -m "not network"          # offline: indicator math, 52-week range, error handling, tool schema
pytest tests/test_mcp_e2e.py -v  # end to end: starts the real server over stdio and calls every tool through the protocol (needs internet)

Disclaimer

Informational only — not financial advice. Market data comes from Yahoo Finance and is subject to Yahoo's terms of use.

License

MIT © Khizar Shabir

Available Tools

4 tools
compare_tickersBInspect

Compare total returns of multiple tickers over a period.

A symbol that fails is reported with error and error_type instead of failing the whole call.

Args: tickers: List of symbols, e.g. ['AAPL', 'MSFT', 'VOO']. period: Lookback window for the returns.

Inputs: tickers (required), period.

get_quoteAInspect

Get the current quote for a stock/ETF ticker: price, day change, volume, and 52-week range.

Args: ticker: Symbol like 'AAPL', 'MSFT', 'VOO'.

Inputs: ticker (required).

get_technical_signalsAInspect

Compute technical indicators for a ticker: RSI(14), MACD(12,26,9), and SMA 50/200 relationships.

Returns measurements and standard threshold classifications only — interpretation is left to the caller. Classifications used:

  • rsi_zone: 'overbought' if RSI >= 70, 'oversold' if RSI <= 30, else 'neutral' (standard Wilder thresholds)

  • macd.vs_signal: MACD line position relative to its 9-period signal line, including single-day crossovers

  • moving_averages.sma_50_vs_200: 'golden_cross' if SMA50 > SMA200, 'death_cross' otherwise (standard definitions)

Args: ticker: Symbol like 'AAPL', 'NVDA'.

Inputs: ticker (required).

weekly_digestAInspect

One-call weekly portfolio report: 1-week and 1-month returns plus indicator readings for each holding. Ideal for a recurring 'weekly portfolio signals' check-in.

Args: tickers: Portfolio symbols, e.g. ['AAPL', 'NVDA', 'VOO'].

Inputs: tickers (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 4 tools

    Disambiguation4/5

    The four tools have mostly distinct purposes: quote retrieval, technical indicator computation, multi-ticker comparison, and a composite weekly digest. The only mild overlap is between compare_tickers and weekly_digest, since the digest includes returns and indicator readings, but the digest's recurring-report framing makes the boundary reasonably clear.

    Naming Consistency4/5

    Names use snake_case throughout, with three following a clear verb_noun pattern: get_quote, get_technical_signals, and compare_tickers. weekly_digest is a noun phrase rather than verb-led, which is a minor but understandable deviation.

    Tool Count5/5

    Four tools is well-scoped for a portfolio-signals server: one quote tool, one technical-signals tool, one comparison tool, and one digest tool. Each has a clear role and the set avoids unnecessary surface area.

    Completeness4/5

    The surface covers the core workflow of retrieving quotes, computing technical signals, comparing returns, and producing a weekly portfolio digest. Minor gaps remain, such as standalone historical price retrieval or richer risk/portfolio analytics, but the essential signals domain is covered.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to retrieve real-time stock data, manage watchlists, and perform comprehensive technical analysis using Yahoo Finance API. Provides 18+ tools for stock price tracking, trend analysis, volatility assessment, and financial indicators through MCP integration.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides real-time stock quotes, historical data, and stock search via Yahoo Finance, enabling AI assistants to access and analyze financial market data.
      24 npm
      19
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform live stock and portfolio research using Yahoo Finance data, including quotes, fundamentals, price history, news, portfolio analysis, and ticker comparisons.
      -