Skip to main content
Glama
Portfolio Analytics MCP

Portfolio Analytics MCP

by RugSec
README.md
# Portfolio Analytics MCP

[![PyPI](https://img.shields.io/pypi/v/portfolio-analytics-mcp.svg)](https://pypi.org/project/portfolio-analytics-mcp/)
[![CI](https://github.com/RugSec/portfolio-analytics-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/RugSec/portfolio-analytics-mcp/actions/workflows/ci.yml)
[![Python 3.12](https://img.shields.io/badge/python-3.12-blue.svg)](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/pyproject.toml)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/LICENSE)

**Ask Claude about your investments in plain language.** This is an
[MCP](https://modelcontextprotocol.io) server that gives Claude (or any MCP
client) read-only tools for market data and portfolio analysis: prices, FX,
ETF costs and exposure, and risk for a whole portfolio of stocks and ETFs,
measured in your own currency.

It is built for European investors as much as US ones: it understands ISINs,
UCITS ETFs listed on several exchanges, and prices quoted in pence.

## What you can ask

> "I hold 30k EUR of IE00B4L5Y983, 10 ASML.AS and 25 AAPL. How volatile is
> this portfolio, and which position contributes most to the risk?"

> "Compare the costs of the iShares Core MSCI World and the Vanguard FTSE
> All-World. Which is cheaper and bigger?"

> "How much of my ETF portfolio is in US tech stocks? Do my ETFs overlap?"

> "What has VWCE returned since 2021 in euros, compared with the S&P 500?"

Claude picks the right tools, fetches the data and explains the result.

## What's inside

| Area          | What it gives you                                                                                      | Data source                                |
| ------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------ |
| **Portfolio** | Risk and return of a mixed portfolio in one currency: volatility, drawdown, beta, risk per position    | Yahoo Finance + justETF                    |
| **ETFs**      | Costs (TER), fund size, country/sector/stock exposure, listings, similar funds, portfolio look-through | [justETF](https://www.justetf.com)         |
| **Markets**   | Price history, quotes, FX rates, performance statistics, correlations, dividends                       | [Yahoo Finance](https://finance.yahoo.com) |

20 tools in total, all read-only. No API key or account needed. See the
[user guide](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/docs/USER_GUIDE.md) for the full list.

## Quickstart

You need [uv](https://docs.astral.sh/uv/getting-started/installation/). It
downloads Python 3.12, the server and its dependencies on first run, and
checks for a new release each time the server starts.

**1. Connect it to Claude**

Claude Code:

```bash
claude mcp add finance -- uvx portfolio-analytics-mcp@latest
```

Claude Desktop: add this to `claude_desktop_config.json`, then restart the
app. If it can't find `uvx`, use the full path that `which uvx` prints.

```json
{
  "mcpServers": {
    "finance": {
      "command": "uvx",
      "args": ["portfolio-analytics-mcp@latest"]
    }
  }
}
```

To stay on one version instead, use `portfolio-analytics-mcp==0.2.0`.

The server runs on your machine. Only symbols and ISINs go out, to Yahoo
Finance and justETF; your quantities and amounts never leave it.

**2. Ask a question**, for example _"What is the TER of IE00B4L5Y983?"_

To work on the code instead, see [Contributing](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/CONTRIBUTING.md#setup).

Want to run it as a shared remote server instead? See
[Remote deployment](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/docs/USER_GUIDE.md#remote-deployment-http).

## Important to know

- **Not financial advice.** The tools report data and statistics; past
  performance does not predict future results. Data can be delayed,
  incomplete or wrong, and is provided as is, without warranty.
- **Not affiliated** with Yahoo, justETF or any fund provider. Names and
  trademarks belong to their owners.
- **Personal use only.** Yahoo Finance (through the unofficial
  [yfinance](https://pypi.org/project/yfinance/) library) and justETF are
  third-party sites. This server makes polite, on-demand requests
  (rate-limited and cached) and is not meant for bulk downloads or
  redistributing their data. Check their terms before using it.
- Quotes can be delayed by up to ~20 minutes, and Yahoo's coverage of
  European ETF holdings is patchy (the justETF tools fill that gap).

## Learn more

- [User guide](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/docs/USER_GUIDE.md): every tool, example workflows,
  configuration, remote deployment and limitations.
- [Agent skill](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/skill/portfolio-analytics/SKILL.md): tells an agent when
  and how to use the tools, and how to present results.
- [Contributing](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/CONTRIBUTING.md): development setup, tests and project
  layout.

## License

[MIT](https://github.com/RugSec/portfolio-analytics-mcp/blob/main/LICENSE)

TDQS

A4/5.0

Scored across 20 tools

Disambiguation4/5

Most tools have clearly distinct roles: justETF/ISIN tools versus Yahoo/ticker tools versus portfolio-level analytics. The main ambiguity is between ETF exposure tools (get_etf_sector_allocation, get_etf_holdings, get_etf_exposure) and between search/resolve tools (search_symbol, search_etf, resolve_instrument), but the descriptions explicitly guide correct selection. A few boundaries require reading descriptions, so not perfect but strong.

Naming Consistency5/5

All names use consistent snake_case with predictable verb_noun or verb_resource patterns. Variations like get_, search_, compare_, analyze_ and resolve_ are semantically appropriate rather than inconsistent. No camelCase or chaotic naming.

Tool Count4/5

Twenty tools is slightly heavy, but the domain is broad: ETF discovery, metadata, prices, quotes, FX, statistics, correlations, dividends, comparisons and portfolio risk. Each tool serves a distinct workflow, though a few Yahoo/justETF duplicates could be consolidated. Overall well-scoped rather than bloated.

Completeness4/5

The surface covers the main portfolio analytics lifecycle: instrument search/resolution, ETF research, market data, risk/return statistics, correlation, dividends and portfolio-level look-through and risk analysis. Minor gaps exist around portfolio persistence and full index/ETF constituent data beyond top holdings, but these are workaroundable or outside the stated analytics scope.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues