Skip to main content

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

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"]
    }
  }
}

Remote (HTTP)

No local install — connects directly to the hosted instance:

claude mcp add --transport http portfolio-signals https://portfolio-signals-mcp.fly.dev/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

Metadata

Release files for portfolio-signals-mcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for portfolio-signals-mcp 0.1.2
File Size Uploaded Provenance Actions
portfolio_signals_mcp-0.1.2.tar.gz 9.2 kB Without provenance Details for portfolio_signals_mcp-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for portfolio-signals-mcp 0.1.2
File Interpreter ABI Platform Actions
portfolio_signals_mcp-0.1.2-py3-none-any.whl Python 3 none any Details for portfolio_signals_mcp-0.1.2-py3-none-any.whl

Total release size: 17.1 kB

Release files / portfolio_signals_mcp-0.1.2.tar.gz

Download URL portfolio_signals_mcp-0.1.2.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
2fd4b465d8919d2463f1635a5afcaeaf3fe38e639319e73087a3e5551873e884
BLAKE2b-256 checksum
How to use checksums
a26307d5022cfc724e85638b66d5e44c31f53efc7ba84e3de4762565c45ddb39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / portfolio_signals_mcp-0.1.2-py3-none-any.whl

Download URL portfolio_signals_mcp-0.1.2-py3-none-any.whl
Size 7.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
78ac96080482db400c10c6cab88b22d5cf78320353add0b956a751c5273aa837
BLAKE2b-256 checksum
How to use checksums
1ff8b524dc7b12ac0466c77ac388fe4991152db5b97c8f47cf93afc9eec3722d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for portfolio-signals-mcp 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page