Analyze a Stock
stock_analysisPublic market numbers for one US stock or ETF.
Returns price, day change, 52-week range, market cap and trailing P/E. Use this when the user asks about a specific ticker, for example AAPL or BRK.B. Don't use it for the user's own holdings (use list_portfolio) or for buy/sell decisions.
Limits: US tickers only; data from Yahoo Finance, up to 15 minutes old; without sign-in there is a shared daily limit. When signed in, the answer also says whether the ticker is on the user's watchlist. Educational information, not investment advice.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"ticker": "<ticker>"
},
"name": "stock_analysis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ticker | Yes | US stock or ETF ticker, for example AAPL or BRK.B. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| as_of | No | ||
| price | No | ||
| source | Yes | ||
| ticker | Yes | ||
| currency | No | ||
| pe_ratio | No | ||
| narrative | Yes | ||
| change_abs | No | ||
| change_pct | No | ||
| market_cap | No | ||
| week52_low | No | ||
| data_status | No | ok = numbers found; not_found = no such ticker; unavailable = market data is down; busy = try again in a minute; limit = signed-out daily limit reached. | |
| week52_high | No | ||
| sign_in_hint | No | A sign-in or setup tip. Never a paid offer. |