Portfolio Signals

io.github.KhizarShabir1Published by GitHub account KhizarShabir1v0.1.2Updated Oct 24, 2026

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

The publisher's own server: SIGNALS Loyalty Agent Platform

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

An MCP server that gives an assistant real-time stock quotes and computed technical signals such as RSI, MACD and SMA crossovers from Yahoo Finance data.

What you can do
Fetch a single ticker's price, day change, volume and 52-week range, plus RSI(14) zone, MACD versus signal line and SMA 50/200 golden or death cross readings computed in code rather than by the model. Rank several tickers by total return over periods from one month to five years. Produce a whole-portfolio weekly digest with 1-week and 1-month returns, RSI and MACD positions, and tickers outside the RSI 30-70 band. Tools return measurements and standard threshold classifications only, leaving interpretation to the assistant.
When to use it
Useful when you want an assistant to look up current quotes or indicator readings for specific tickers, compare returns across a watchlist, or assemble a recurring portfolio summary without doing the arithmetic itself.
Requirements
Either the hosted HTTP endpoint or a local install; the local package runs via uvx or pip and needs Python. Market data comes from Yahoo Finance through yfinance, so network access is required. No API key or account is needed.
Before you install
Output is informational only and not financial advice; market data is subject to Yahoo's terms of use. Signals are threshold classifications, not buy or sell recommendations, and the assistant may present them as opinions. The server is read-only and does not place trades or touch brokerage accounts.

Installation

In SourceWeft

  1. Open Portfolio Signals in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.KhizarShabir1%2Fportfolio-signals/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "portfolio-signals": {
      "type": "http",
      "url": "https://portfolio-signals-mcp.fly.dev/mcp"
    }
  }
}

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.

Quick start

No install needed if you have uv:

bash
uvx portfolio-signals-mcp

Claude Code

bash
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:

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

Claude Desktop

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

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

Remote (HTTP)

No local install — connects directly to the hosted instance:

bash
claude mcp add --transport http portfolio-signals https://portfolio-signals-mcp.fly.dev/mcp

From source

bash
git clone https://github.com/KhizarShabir1/portfolio-signals-mcpcd portfolio-signals-mcppip install -e .portfolio-signals-mcp           # stdioportfolio-signals-mcp --http    # streamable HTTP on :8000 (PORT env to change)

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

Source: README.md at commit 80ad75c

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Signals integrations