portfolio-signals-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@portfolio-signals-mcp what's the RSI and MACD on NVDA right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Portfolio Signals MCP
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 |
| Price, day change, volume, 52-week range |
| RSI(14) with overbought/oversold zone, MACD(12,26,9) vs signal line, SMA 50/200 golden/death cross |
| Ranked total returns over 1mo–5y |
| 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-mcpClaude Code
claude mcp add portfolio-signals -- uvx portfolio-signals-mcpThen 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 toolscompare_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Yahoo Finance for AI agents: quotes, price history, options with Greeks, financials, news, movers.
Yahoo Finance stock quotes and multi-ticker comparison as agent tools.
Real-time Yahoo Finance stock/crypto quotes & options, Google Trends, News & Reddit/HN sentiment.
Live stock quotes, a stock screener, crypto prices and FX rates as agent tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceProvides real-time stock quotes, historical data, and stock search via Yahoo Finance, enabling AI assistants to access and analyze financial market data.24 npm19MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access real-time stock, crypto, and market index data from Yahoo Finance, supporting queries for prices, history, company info, and comparisons.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform live stock and portfolio research using Yahoo Finance data, including quotes, fundamentals, price history, news, portfolio analysis, and ticker comparisons.-