Back to Browse

Portfolio Signals MCP Server

Developer ToolsModerate5.2MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

Real-time stock quotes and technical signals: RSI, MACD, SMA crossovers via Yahoo Finance.

About

Real-time stock quotes and technical signals: RSI, MACD, SMA crossovers via Yahoo Finance.

Remote endpoints: streamable-http: https://portfolio-signals-mcp.fly.dev/mcp

Security Report

5.2
Moderate5.2Moderate Risk

A well-engineered MCP server for stock quotes and technical analysis indicators. The codebase is clean, properly structured, and free of authentication/credential issues. Tools correctly expose only measurements and threshold classifications rather than directional financial advice. Permissions (network_http, env_vars) match the server's purpose of fetching Yahoo Finance data and hosting an HTTP endpoint. Minor code quality observations noted but do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

6 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

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

ToolWhat 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).

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

Reviews

No reviews yet

Be the first to review this server!