What is MCP, in two minutes
MCP (Model Context Protocol) is the standard plug between an AI assistant and outside tools. Without it, Claude or ChatGPT answers from what it remembers; with it, the assistant can call a tool when a question needs real data, and answer from what comes back. You add one link, once.
- 01You add one linkIn Claude, ChatGPT, Cursor or Claude Code, once. Nothing to install, nothing to sign up for on the free tools.
- 02The assistant calls a toolWhen a question needs real data (what does VOO hold, what would a sale save me) it calls the right tool by itself.
- 03It answers with the sourceThe figure comes back with its date, its rule and the page it came from, so you can check every number.
Add it to your assistant
- Claudeclaude.ai and the desktop appSettings › Connectors › Add custom connectorName it Portfolio Terminal and paste the URL aboveNo sign-in step: the server has no account
- ChatGPTweb, with developer modeSettings › Apps & Connectors › Advanced: turn on Developer modeBack in Apps & Connectors: Create, paste the URLAuthentication: No authentication
- Claude CodeterminalRun this once; the tools appear in /mcp
claude mcp add --transport http portfolio-terminal https://portfolio-terminal.com/api/mcp - Cursor~/.cursor/mcp.jsonAdd the server to the file, then enable it in Settings › MCP
{ "mcpServers": { "portfolio-terminal": { "url": "https://portfolio-terminal.com/api/mcp" } } } - VS Code.vscode/mcp.jsonAdd the server, then start it from the file or the MCP view
{ "servers": { "portfolio-terminal": { "type": "http", "url": "https://portfolio-terminal.com/api/mcp" } } }
What your assistant can look up and compute
analyze_tickerStock, ETF or coin key factsAsk: “How far is Nvidia from its all-time high, and what does its chart say?”who_holdsWhich ETFs and famous investors hold a stockAsk: “Which ETFs hold Palantir, and do any famous investors own it?”etf_holdingsEverything an ETF holdsAsk: “What are the top 10 holdings of SCHD, and how concentrated is it?”etf_overlapHow much two ETFs overlapAsk: “How much do VOO and QQQ overlap?”compareHead-to-head of two stocks or ETFsAsk: “SCHD or VIG over five years: returns, drawdown, fees?”dividend_calendarDividend calendarAsk: “Which stocks go ex-dividend in the next 10 days?”earnings_calendarEarnings calendarAsk: “Who reports earnings this week, before the open or after the close?”tax_loss_harvestTax-loss harvesting before December 31Ask: “I sold VTI at a loss at Schwab last week and buy it every month in my Roth IRA: how much loss can I still deduct this year, and is it a wash sale?”withholding_checkDividend tax withheld abroadAsk: “I live in France and got €1,200 of Nestlé dividends and €400 of Allianz dividends this year: how much tax was withheld above the treaty rate?”fund_feesWhat your funds cost a yearAsk: “I have $40,000 in VOO, $25,000 in SCHD and $10,000 in ARKK: what do their fees cost me a year?”
What it does, and what it never does
- Read-only: the market tools answer from pages anyone can open on portfolio-terminal.com. The server never reads your Portfolio Terminal account.
- Three tools (tax_loss_harvest, withholding_check, fund_fees) compute on the holdings your assistant passes in the call: tickers, shares, prices and dates, account types, dividend or fund amounts. They answer and keep nothing: no account, nothing saved, and the logs hold only the tool's name and the number of lines, never a ticker or an amount.
- Tax figures come with the rule that gives them (IRS Publication 550, the French CGI) and the day they were computed. Whether two funds are "substantially identical" is flagged, never decided.
- No account and no key. Nothing to sign up for, nothing to revoke.
- Every figure is dated, and every answer carries the URL of the page it came from, which your assistant is asked to cite.
- Information, not advice: the server tells the assistant to describe what the data says and never to tell anyone to buy or sell.
- Fair use: 60 requests a minute per network, 20 of them for the lookups that fetch market prices.
- Sources: daily prices and fund expense ratios from Yahoo Finance, the ECB's reference rates, each issuer's full holdings file, the funds' SEC N-PORT reports and the investors' SEC Form 13F filings.
What people ask before adding it
What is an MCP server?
MCP (Model Context Protocol) is the standard AI assistants use to call outside tools. An MCP server is a list of tools behind one URL: once you add the URL, the assistant decides when a question needs one of them, calls it, and answers from what comes back.
Can the assistant see my portfolio through it?
Not through the free server: it cannot read your Portfolio Terminal account. The tax-loss, withholding and fee tools see only the lines your assistant sends in that call, compute the answer and keep nothing; the market tools answer from public pages of portfolio-terminal.com. Reading your saved portfolio is MCP Premium, below.
What is MCP Premium?
Part of the $80 plan (80 € for residents of France), from December 1: a private link to your own account, so the assistant answers from your saved lines and your audit's figures, each one dated. It is read-only (no order, no transfer), it never sees your broker login, and you can cut the link at any time.
Is it free?
Yes, with no account and no key. It is limited per network so it stays fast for everyone, the same way the public pages are.
Which tickers does it cover?
Key facts and comparisons cover 390 US stocks, 30 ETFs, 17 cryptocurrencies and 4 commodity futures. ETF holdings cover the 54 most-searched US ETFs from their issuers, and about forty more funds from SEC N-PORT. "Who holds" works on any US-listed stock in those funds.
Which version of MCP does it speak?
Streamable HTTP, the current 2026-07-28 revision as well as 2025-03-26, 2025-06-18 and 2025-11-25, which most assistants still use. Answers are plain JSON, with no session to keep open.