Dated ETF, stock and calendar data, plus tax-loss, withholding and fee math on your holdings.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Dated key facts and a plain-English chart read for one ticker Portfolio Terminal covers (390 US stocks, 30 ETFs, 17 cryptocurrencies and 4 commodity futures): price and one-year change, 52-week range, distance from the 200-day average, 30-day volatility with a risk rating, P/E and dividend yield, all-time high and "lowest since", ten years against the S&P 500 (SPY), support and resistance levels, which tracked ETFs and famous investors (13F) hold it, and related research. Use it for "how is NVDA doing", "is TSLA near its high", "what does the AAPL chart say".
The ticker as listed in the US ("NVDA", "VOO", "BRK.B"), a coin ("BTC" or "BTC-USD") or a future ("GC=F" for gold).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http portfolio-terminal https://portfolio-terminal.com/api/mcp
Dated key facts and a plain-English chart read for one ticker Portfolio Terminal covers (390 US stocks, 30 ETFs, 17 cryptocurrencies and 4 commodity futures): price and one-year change, 52-week range, distance from the 200-day average, 30-day volatility with a risk rating, P/E and dividend yield, all-time high and "lowest since", ten years against the S&P 500 (SPY), support and resistance levels, which tracked ETFs and famous investors (13F) hold it, and related research. Use it for "how is NVDA doing", "is TSLA near its high", "what does the AAPL chart say".
| Argument | Type | Description |
|---|---|---|
| ticker* | string | The ticker as listed in the US ("NVDA", "VOO", "BRK.B"), a coin ("BTC" or "BTC-USD") or a future ("GC=F" for gold). |
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"NVDA",
"VOO",
"BRK.B",
"BTC"
],
"maxLength": 20,
"minLength": 1,
"description": "The ticker as listed in the US (\"NVDA\", \"VOO\", \"BRK.B\"), a coin (\"BTC\" or \"BTC-USD\") or a future (\"GC=F\" for gold)."
}
},
"additionalProperties": false
}Five-year head-to-head of two covered stocks or ETFs from weekly closes adjusted for dividends and splits: total and annualized return, 1-, 3- and 5-year returns, volatility, worst drawdown and worst week, correlation, what $10,000 became, plus each one's dividend yield, beta and (for funds) fee. Use it for "SCHD vs VIG", "NVDA vs AMD".
| Argument | Type | Description |
|---|---|---|
| a* | string | First ticker, e.g. "SCHD". |
| b* | string | Second ticker, e.g. "VIG". |
{
"type": "object",
"required": [
"a",
"b"
],
"properties": {
"a": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"SCHD",
"NVDA"
],
"maxLength": 20,
"minLength": 1,
"description": "First ticker, e.g. \"SCHD\"."
},
"b": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"VIG",
"AMD"
],
"maxLength": 20,
"minLength": 1,
"description": "Second ticker, e.g. \"VIG\"."
}
},
"additionalProperties": false
}US stocks and ETFs (of the 420 Portfolio Terminal covers) going ex-dividend in a month or a date range: ex-dividend date, pay date, dividend per share, yield, frequency, and whether the date is confirmed by the company or estimated from its payment rhythm. Buy before the ex-date to receive the dividend. Filter by one ticker with `symbol`.
| Argument | Type | Description |
|---|---|---|
| days | integer | Length of the range that starts at `from`, in calendar days (1–31, default 10). |
| from | string | First day of a date range, YYYY-MM-DD (instead of `month`). Use it for "this week" or "the next 10 days". |
| limit | integer | How many entries, earliest first to return (1–200, default 50). |
| month | string | A calendar month as YYYY-MM, from three months back to three months ahead. Defaults to the current month. Ignored when `from` is given. |
| symbol | string | Only this ticker, e.g. "KO". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 10,
"maximum": 31,
"minimum": 1,
"description": "Length of the range that starts at `from`, in calendar days (1–31, default 10)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"examples": [
"2026-10-06"
],
"description": "First day of a date range, YYYY-MM-DD (instead of `month`). Use it for \"this week\" or \"the next 10 days\"."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "How many entries, earliest first to return (1–200, default 50)."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"examples": [
"2026-10"
],
"description": "A calendar month as YYYY-MM, from three months back to three months ahead. Defaults to the current month. Ignored when `from` is given."
},
"symbol": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"KO"
],
"maxLength": 20,
"minLength": 1,
"description": "Only this ticker, e.g. \"KO\"."
}
},
"additionalProperties": false
}US companies (of the 390 Portfolio Terminal covers) reporting earnings in a month or a date range: the day, before the open or after the close, EPS and revenue estimates, whether the date is confirmed or estimated, and once out, the result against the consensus and how many recent quarters beat it. Filter by one ticker with `symbol`.
| Argument | Type | Description |
|---|---|---|
| days | integer | Length of the range that starts at `from`, in calendar days (1–31, default 10). |
| from | string | First day of a date range, YYYY-MM-DD (instead of `month`). Use it for "this week" or "the next 10 days". |
| limit | integer | How many reports, earliest first, larger companies first on the same day to return (1–200, default 50). |
| month | string | A calendar month as YYYY-MM, from three months back to three months ahead. Defaults to the current month. Ignored when `from` is given. |
| symbol | string | Only this ticker, e.g. "NVDA". |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 10,
"maximum": 31,
"minimum": 1,
"description": "Length of the range that starts at `from`, in calendar days (1–31, default 10)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"examples": [
"2026-10-06"
],
"description": "First day of a date range, YYYY-MM-DD (instead of `month`). Use it for \"this week\" or \"the next 10 days\"."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 200,
"minimum": 1,
"description": "How many reports, earliest first, larger companies first on the same day to return (1–200, default 50)."
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"examples": [
"2026-10"
],
"description": "A calendar month as YYYY-MM, from three months back to three months ahead. Defaults to the current month. Ignored when `from` is given."
},
"symbol": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"NVDA"
],
"maxLength": 20,
"minLength": 1,
"description": "Only this ticker, e.g. \"NVDA\"."
}
},
"additionalProperties": false
}An ETF's or index fund's holdings from the issuer's full file (or its latest SEC N-PORT report for funds outside the catalog): the largest lines with their weights, the sector mix, and how concentrated it is (weight of the top 10, how many names make up half the fund, effective number of holdings). Share classes of one fund (VFIAX → VOO) resolve to its file.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many holdings, largest first to return (1–100, default 25). |
| ticker* | string | The fund ticker, e.g. "VOO", "QQQ", "SCHD", "AVUV". |
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "How many holdings, largest first to return (1–100, default 25)."
},
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"VOO",
"QQQ",
"SCHD"
],
"maxLength": 20,
"minLength": 1,
"description": "The fund ticker, e.g. \"VOO\", \"QQQ\", \"SCHD\", \"AVUV\"."
}
},
"additionalProperties": false
}How much of two ETFs is the same money: overlap by weight (the sum, over companies both hold, of the smaller of the two weights), how many companies they share, what share of each fund sits in names the other also holds, and the largest shared holdings. Full issuer files, matched on ISIN. Use it for "VOO vs QQQ overlap", "is IVV the same as VOO".
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many shared holdings to return (1–50, default 10). |
| fund_a* | string | First fund ticker, e.g. "VOO". |
| fund_b* | string | Second fund ticker, e.g. "QQQ". |
{
"type": "object",
"required": [
"fund_a",
"fund_b"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "How many shared holdings to return (1–50, default 10)."
},
"fund_a": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"VOO"
],
"maxLength": 20,
"minLength": 1,
"description": "First fund ticker, e.g. \"VOO\"."
},
"fund_b": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"QQQ"
],
"maxLength": 20,
"minLength": 1,
"description": "Second fund ticker, e.g. \"QQQ\"."
}
},
"additionalProperties": false
}Computes, on the funds and amounts the user gives, what each fund's expense ratio takes a year (amount × expense ratio), the total and the weighted ratio, with the expense ratios of Portfolio Terminal's fees view (the fund's latest annual report as Yahoo Finance lists it). A fact, not a verdict: no other fund is suggested. A line that is not a fund, or whose ratio is not published, is named. Nothing is stored. Use it for "how much do my ETFs cost me a year".
| Argument | Type | Description |
|---|---|---|
| funds* | array | One line per fund: its ticker and what is invested in it now. At most 50. |
| currency | string | Currency of every amount (default USD). |
{
"type": "object",
"required": [
"funds"
],
"properties": {
"funds": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"amount"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "What the holding is worth now, in `currency`."
},
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"VOO",
"IWDA.AS"
],
"maxLength": 20,
"minLength": 1,
"description": "The fund's ticker: \"VOO\", \"SCHD\", \"IWDA.AS\"."
}
},
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "One line per fund: its ticker and what is invested in it now. At most 50."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"examples": [
"USD",
"EUR"
],
"description": "Currency of every amount (default USD)."
}
},
"additionalProperties": false
}Computes, on the lots the user gives (ticker, shares, price, date, account and its type), the losses a sale before December 31 would realize and what they offset, with the engine of Portfolio Terminal's "Before December 31" panel. US resident: FIFO lots per account, short vs long term, this year's realized gains, the year netted as Schedule D nets it (the $3,000 off ordinary income, the carryforward), and the wash-sale rule across every account, IRA and 401(k) included: losses it took this year, windows still open, and the first day the same security can be bought back without one (IRS Publication 550). French resident: weighted average cost across accounts at ECB rates, PEA and crypto left out, and the flat tax those losses erase against this year's net gains (CGI art. 150-0 D, 200 A). Funds on the same index are flagged, never judged "substantially identical". Current prices are fetched unless given in `prices`. Nothing is stored. Use it for "how much tax can my losses save before December 31", "would this be a wash sale".
| Argument | Type | Description |
|---|---|---|
| lots* | array | Every purchase of the shares held, one per lot; add this year's sales (side "sell") with the purchases they came from, so realized gains and wash sales count. At most 300. |
| prices | array | Current price per share by ticker, in the lots' currency, when the user gave it. Tickers left out are priced from Yahoo Finance. At most 150. |
| carryover | object | US only: capital losses carried into this year from last year's return, in dollars, by term. |
| residence* | string |
Which of the 54 tracked US ETFs hold a US-listed stock (weight and rank, from each issuer's full holdings file, matched on ISIN), and which famous investors hold it in their latest SEC Form 13F (share of their reported portfolio, rank, quarter). Offline data: fast, no market call. Use it for "which ETFs hold PLTR", "does Buffett own Apple".
| Argument | Type | Description |
|---|---|---|
| ticker* | string | A US stock ticker, e.g. "NVDA", "BRK.B". |
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"NVDA",
"AAPL",
"BRK.B"
],
"maxLength": 20,
"minLength": 1,
"description": "A US stock ticker, e.g. \"NVDA\", \"BRK.B\"."
}
},
"additionalProperties": false
}Computes, on the dividends the user gives (a year of dividends, gross, by payer: a ticker such as "NESN.SW" or a country code), the tax each payer's country keeps at source, the treaty rate, and what was withheld above it over 12 months, which only that country refunds on a claim; for a French resident, also the treaty part France credits on form 2047. Same engine as Portfolio Terminal's Income and Pro tabs: statutory rates as of 2026, a US dividend at 15% (W-8BEN on file), European-listed funds paying no withholding. Countries outside its table are named, never guessed. Nothing is stored. Use it for "how much Swiss tax do I lose on Nestlé dividends", "which of my dividends are over-withheld".
| Argument | Type | Description |
|---|---|---|
| currency | string | Currency of every amount (default EUR for FR, USD otherwise). |
| dividends* | array | One line per payer: a year of dividends, gross (before any tax). At most 100. |
| residence* | string | Where the user pays tax: FR (France), US, or other (the usual 15% treaty rate is used). |
{
"type": "object",
"required": [
"residence",
"dividends"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"examples": [
"USD",
"EUR"
],
"description": "Currency of every amount (default EUR for FR, USD otherwise)."
},
"dividends": {
"type": "array",
"items": {
"type": "object",
"required": [
"amount"
],
"properties": {
"kind": {
"enum": [
"stock",
"fund"
],
"type": "string",
"description": "stock (default) or fund: a fund listed in Europe pays its holders no withholding."
},
"amount": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Dividends over 12 months, gross, in `currency`."
},
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"NESN.SW",
"ALV.DE",
"MSFT"
],
"maxLength": 20,
"minLength": 1,
"description": "The payer's ticker with its exchange suffix: \"NESN.SW\", \"ALV.DE\", \"MSFT\"."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"examples": [
"CH",
"DE"
],
"description": "The payer's country, ISO code (\"CH\", \"DE\", \"US\"), when there is no ticker or it says better."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1,
"description": "One line per payer: a year of dividends, gross (before any tax). At most 100."
},
"residence": {
"enum": [
"FR",
"US",
"other"
],
"type": "string",
"description": "Where the user pays tax: FR (France), US, or other (the usual 15% treaty rate is used)."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 1, 2026.
| Where the user pays tax: US or FR (France). |
| filing_status | string | US only: Form 1040 filing status (default single). Married filing separately caps the deduction at $1,500. |
{
"type": "object",
"required": [
"residence",
"lots"
],
"properties": {
"lots": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"quantity",
"price"
],
"properties": {
"fee": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Commission on this trade, in `currency` (default 0)."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$",
"examples": [
"2025-03-14"
],
"description": "Trade date, YYYY-MM-DD. Needed for a sale, and for wash sales and short vs long term (US). Without it a holding is valued at its cost and its term is unknown."
},
"side": {
"enum": [
"buy",
"sell"
],
"type": "string",
"default": "buy",
"description": "buy (default) for shares bought, sell for a sale already made."
},
"price": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Per share, in `currency`: what was paid for a buy, what was received for a sale."
},
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"NVDA",
"VOO",
"MC.PA"
],
"maxLength": 20,
"minLength": 1,
"description": "The ticker as the broker lists it: \"NVDA\", \"VOO\", \"MC.PA\", \"IWDA.AS\"."
},
"account": {
"type": "string",
"maxLength": 60,
"description": "The account's name, e.g. \"Schwab\", \"Fidelity Roth IRA\", \"Boursorama PEA\". Lots with the same name are one account."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"examples": [
"USD",
"EUR"
],
"description": "Currency of `price` and `fee` (default: the listing's currency)."
},
"quantity": {
"type": "number",
"maximum": 1000000000000,
"minimum": 1e-9,
"description": "Number of shares (fractions allowed)."
},
"account_type": {
"enum": [
"taxable",
"ira",
"roth_ira",
"401k",
"pea",
"cto"
],
"type": "string",
"description": "taxable (US brokerage), ira (traditional IRA), roth_ira, 401k (any workplace plan), pea (French PEA) or cto (French compte-titres). Default: what the account name says, else taxable/CTO."
}
},
"additionalProperties": false
},
"maxItems": 300,
"minItems": 1,
"description": "Every purchase of the shares held, one per lot; add this year's sales (side \"sell\") with the purchases they came from, so realized gains and wash sales count. At most 300."
},
"prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"price"
],
"properties": {
"price": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Price per share now."
},
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.^=\\-]{1,20}$",
"examples": [
"NVDA"
],
"maxLength": 20,
"minLength": 1,
"description": "The ticker."
}
},
"additionalProperties": false
},
"maxItems": 150,
"description": "Current price per share by ticker, in the lots' currency, when the user gave it. Tickers left out are priced from Yahoo Finance. At most 150."
},
"carryover": {
"type": "object",
"properties": {
"long": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Long-term carryover."
},
"short": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Short-term carryover."
}
},
"description": "US only: capital losses carried into this year from last year's return, in dollars, by term.",
"additionalProperties": false
},
"residence": {
"enum": [
"US",
"FR"
],
"type": "string",
"description": "Where the user pays tax: US or FR (France)."
},
"filing_status": {
"enum": [
"single",
"married-joint",
"married-separate",
"head-of-household",
"surviving-spouse"
],
"type": "string",
"description": "US only: Form 1040 filing status (default single). Married filing separately caps the deduction at $1,500."
}
},
"additionalProperties": false
}