SmartFin
v3.0.0Backtest S&P 500 stocks and ETFs on real prices, plus loan, savings, FIRE and retirement tools.
Endpoint health
online- Last checked
- 11/20/2026, 9:15:33 AM
- Latency
- 95 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:fyi.smartfin%2Fsmartfin
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"fyi.smartfin/smartfin": {
"url": "https://smartfin.fyi/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
21 shown · authentication unknown
Falls and recoveries of a stock or fund
smartfin_calculate_crash_recovery
Every fall of a chosen size (default 20%) from a running high for one US-listed stock or index ETF, on daily closing prices adjusted for stock splits with dividends reinvested, the way SmartFin's Crash & Recovery page measures it. For each fall: the high date and close, the bottom date and close, the depth, the first close back at the high (or that it is not yet back), and the months from the high to the bottom and from the high back to it. A summary: how many falls, the deepest, the longest and median months back, how many not yet back, and the latest close against the high. For the deepest fall: what a buy at the high and a buy at the bottom did, SPY from its own close on the same high date (the benchmark), and buys at the first close 10, 20 and 30% below the high. The same dates at 10, 20, 30 and 50%. With mode crash it measures the symbol's own fall during one named S&P 500 crash instead (dotcom: SPY's 2000-03-24 high to its 2002-10-09 low; 2008: SPY's 2007-10-09 high to its 2009-03-09 low; covid: SPY's 2020-02-19 high to its 2020-03-23 low; 2022: SPY's 2022-01-03 high to its 2022-10-12 low). amount and monthly replay a lump sum and a monthly amount from the deepest fall's high. Use when someone asks how far a stock or fund fell and how long it took to recover, e.g. "how long did Apple take to recover from 2008", "NVDA biggest falls and recovery time" or "how many 20% drops has SPY had". Do not use for forecasts or whether something will recover, for intraday moves, for symbols outside the supported list, or for a price-only basis: every figure includes reinvested dividends. For what an amount became between two dates use smartfin_calculate_investment_return. Limits: today's S&P 500 companies and major index ETFs, prices in US dollars, daily closes; the last 10 years by default, or the full history if shorter; every claim is dated and none is a prediction.
Schema valid · SHA-256 93217ab23b60…
View input schema
{ "type": "object", "properties": { "symbol": { "type": "string", "pattern": "^[A-Za-z][A-Za-z.\\-]{0,9}$", "description": "Stock or ETF symbol, not a company name: AAPL not Apple. Covers 508 symbols: the S&P 500 companies plus the index ETFs SPY, VOO, IVV, QQQ, DIA, IWM, VTI." }, "fall_pct": { "type": "number", "minimum": 5, "maximum": 90, "description": "A fall counts once a close is this % or more below the highest close before it. Default 20. Ignored with mode crash" }, "from_date": { "type": "string", "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$", "description": "First date, YYYY-MM-DD. Omit for 10 years before the latest close, or the full history if shorter. Ignored with mode crash" }, "to_date": { "type": "string", "pattern": "^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$", "description": "Last date, YYYY-MM-DD. Omit for the latest close. Ignored with mode crash" }, "mode": { "type": "string", "enum": [ "size", "crash" ], "description": "size (default): every fall of fall_pct or more over the dates. crash: the symbol's own fall during the named S&P 500 crash, from its highest close between a year before SPY's high and SPY's low" }, "crash": { "type": "string", "enum": [ "dotcom", "2008", "covid", "2022" ], "description": "The crash for mode crash: dotcom (dot-com), 2008 (2008), covid (COVID), 2022 (2022)" }, "amount": { "type": "number", "minimum": 0, "maximum": 1000000000, "description": "Optional lump sum invested at the deepest fall's high, in US dollars: when it was worth that amount again" }, "monthly": { "type": "number", "minimum": 0, "maximum": 10000000, "description": "Optional monthly amount from the deepest fall's high on the first trading day of each month, in US dollars: when it was first worth what had been put in" } }, "required": [ "symbol" ], "additionalProperties": false }
Connections
streamable-http
https://smartfin.fyi/mcp