Connect a brokerage
A brokerage connects the same way a bank does: search for it, sign in on its own screen and pick the accounts to share. Then ask your agent to list your investment accounts. If none appear, the connection didn't include investment data, so reconnect and check that the account is selected.
Holdings and gains
"List every position I hold across all accounts, largest first, with value, cost basis, and gain or loss in dollars and percent."
list_holdings returns the ticker, name, type, quantity, price, value, cost basis and gain or loss for each position, plus portfolio totals. Here's that answer with BankBridge's fictional demo portfolio, as of November 6, 2026:
| Demo ticker | Value | Cost basis | Gain or loss | Share of portfolio |
|---|---|---|---|---|
| NVDA | $14,250 | $5,400 | +$8,850 | 28.4% |
| AAPL | $11,250 | $8,500 | +$2,750 | 22.4% |
| MSFT | $8,500 | $7,200 | +$1,300 | 16.9% |
| SPY | $4,640 | $4,120 | +$520 | 9.3% |
| GOOGL | $4,500 | $4,125 | +$375 | 9.0% |
| VTI | $3,444 | $3,120 | +$324 | 6.9% |
| JPM | $2,120 | $1,850 | +$270 | 4.2% |
| BND | $1,450 | $1,580 | -$130 | 2.9% |
Demo total: $50,154 in value on $35,895 of cost basis, a $14,259 gain. These positions aren't anyone's real account or a suggestion to hold them.
Follow-ups that work well:
- "Which positions are below cost basis, and by how much?"
- "Split the totals by account, so I can see the IRA apart from the taxable account."
- "Which positions are missing a cost basis?"
Allocation
"What percent of my portfolio is each position? What percent is my top three? How much is individual stocks and how much is funds?"
The agent divides each value by the total. In the demo portfolio, the top three positions come to 67.8%, and NVDA alone is 28.4%. The type field separates stocks from ETFs: the demo's five stocks are 81.0% and its three funds, counting the bond ETF, are 19.0%.
Sector and region aren't in the data. If you ask for them, the agent fills them in from what it knows about each ticker, so ask it to mark those lines as its own estimate. A fund's underlying holdings aren't there either, so a position in an S&P 500 fund won't count toward your NVDA share unless you tell the agent how to treat it.
A target you set yourself makes this more useful: "My target is 70% stocks, 20% bonds and 10% cash. How far off am I, in dollars?" That's arithmetic on your own numbers, and the target stays your decision.
Trades and contributions
"List every buy and sell since January 1, with date, ticker, quantity, price and amount. Then total my contributions for the same period."
list_investment_transactions covers buys, sells, cash events, transfers and fees. It filters by type (buy, sell, cash, transfer, fee or cancel), by subtype such as contribution or management fee, and by date. With no dates it covers the last 90 days, so name your period when you want more.
The demo account shows a $500 contribution on the 5th of each month, followed by a buy of VTI for the same amount. Asking "Do I have a pattern of contributions?" turns up that kind of routine, and "What did I pay in fees this year?" gets you another total you'd otherwise add up by hand.
Sign matters when you read raw results: a positive amount is money leaving the account, as with a buy, and a negative amount is money arriving, as with a dividend or a contribution. The agent handles this, but it explains an odd-looking minus sign.
The Claude Code commands
The BankBridge plugin for Claude Code includes two ready-made reports:
/bankbridge:portfolio-healthgives total value, unrealized gain or loss and each position's share, flags anything over 20% of the portfolio, and lists the last 20 transactions./bankbridge:dividendstotals dividends by ticker for a year. See tracking dividends.
The 20% flag is a fixed cutoff the command applies, and whether a position that size suits you is your call. In other agents, paste the prompts on this page. For a set routine, try the five-question health check.
What the data can't tell you
- Up-to-the-second prices. Values come from your brokerage's last report and can lag the market.
- Every cost basis. Some brokerages or positions don't report one. The totals count how many are missing, so the gain figure covers only positions that have a basis.
- Tax lots and your tax picture. Holdings arrive as one line per position, so check specifics such as wash sales and holding periods with your brokerage's statements or a tax professional.
- Performance against a benchmark. The data has no market history, and gain on cost isn't the same as a time-weighted return.
- Accounts you didn't connect. The agent only sees what you linked, so a total can look different from your full net worth.
Connect a brokerage to ask about your own positions, or point your agent at the demo data to try the prompts first.