accueil / serveurs / Géo & Temps / io.marketheist/backtest
io.marketheist/backtest
serveur MCP (Model Context Protocol) · marketheist 1.3.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que io.marketheist/backtest est sûr ?
Au dernier audit MCP Hub, le serveur MCP « io.marketheist/backtest » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 10 outils
- analyze_portfolio≈ 1298 tokens
Analyze an asset-allocation ('lazy') portfolio and get long-run performance computed from real monthly price history (proxy-extended for decades of data), not estimated: CAGR, max drawdown, volatility, Sharpe, Sortino, Ulcer index, $10,000 growth, the number of independent bets (holdings whose returns average a correlation of 0.5 or more count as one group, then the effective count of groups by risk share), the top risk driver, trailing Sharpe, and a `validity` block (provenance, caveats, a reproduce-me hash) plus a `cite` block with the marketheist.io pages that show the same numbers. Use it for 'how did 60/40 / All Weather / Golden Butterfly perform' or for a custom mix. Provide exactly one of: a `template` id (19 model portfolios, listed in list_portfolios), a `strategy` id (7 rule-based canonical strategies, e.g. dual-momentum-gem) or a custom `assets` allocation (plain tickers and nested portfolios, rotations, strategies as holdings via `sleeve`). Template and strategy ids are answered from precomputed data through the stated month (instant, not rate-limited); custom assets and an `overlay` are computed live from market data. For seasonality and calendar years use portfolio_returns; for drawdown episodes and diversification use portfolio_risk; to compare portfolios use compare_portfolios. Read-only; surface the caveats when reporting.
Paramètres, retour & exemple (6)
Paramètreslabel· string · optionnel
Optional display name for a custom `assets` portfolio. Default "Custom portfolio".assets· array · optionnel
Custom allocation (omit if using `template` or `strategy`). Weights are percentages summing to ~100. A holding is a plain ticker OR a strategy node via `sleeve`.overlay· object · optionnel
Optional portfolio-level trend-filter overlay applied to the WHOLE book: hold the entire portfolio only while its own level is above its N-month moving average, otherwise cash. Composition is monthly (a 10-month filter ≈ the classic 200-day one).strategy· string · optionnel · dual-momentum-gem | tsmom-sp500 | faber-trend-timing | sector-momentum-rotation | risk-parity-inverse-vol | gtaa-aggressive | adaptive-asset-allocation
Canonical rule-based strategy to analyze. One of: dual-momentum-gem, tsmom-sp500, faber-trend-timing, sector-momentum-rotation, risk-parity-inverse-vol, gtaa-aggressive, adaptive-asset-allocation. Answered from precomputed data. Omit when using `template` or `assets`.template· string · optionnel · golden-butterfly | all-weather | permanent | dragon | faber-ivy | faber-gaa | bogleheads-3fund | wealthfront-classic
Built-in model portfolio to analyze. One of: golden-butterfly, all-weather, permanent, dragon, faber-ivy, faber-gaa, bogleheads-3fund, wealthfront-classic, betterment-core, classic-60-40, classic-40-60, swensen, ferri-core-four, couch-potato, coffeehouse, no-brainer, larry, buffett-90-10, total-sp500. Omit to analyze a custom `assets` allocation instead.rebalance· string · optionnel · none | monthly | quarterly | yearly
Rebalancing cadence for custom portfolios (templates use their own).
Exemple d'appel{"name": "analyze_portfolio", "arguments": {"label": "texte", "assets": [], "overlay": {}, "strategy": "dual-momentum-gem", "template": "golden-butterfly", "rebalance": "none"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - compare_portfolios≈ 1130 tokens
Compare 2 to 4 portfolios (built-in model portfolios, canonical strategies or your own allocations) side by side over their COMMON window, which is the only fair comparison: two pages' headline numbers usually cover different periods (a portfolio holding gold starts in 2004, the Ivy portfolio in 1996). Returns CAGR, volatility, max drawdown, Sharpe, Sortino, Ulcer index, best/worst year and longest time underwater on the aligned months, each portfolio's own full-window figures (labelled with their start), the pairwise correlation of their monthly returns and a calendar-year table. Use it for 'All Weather vs Golden Butterfly vs 60/40', 'which of these held up better', 'my portfolio vs 60/40'. Each item in `portfolios` has exactly one of `template` or `strategy` (ids from list_portfolios) or `assets` (your own allocation, including nested portfolios, rotations and strategies as holdings, with optional `rebalance` and `overlay`), plus an optional `label`. Ids are precomputed from the monthly refresh; `assets` entries are computed live (at most 2 custom entries and 24 distinct tickers per call). Read-only. For one portfolio's detail use analyze_portfolio, portfolio_returns or portfolio_risk.
Paramètres, retour & exemple (2)
Paramètresyears· integer · optionnel
Calendar-year rows to include (most recent N years of the common window; 0 = none). Default 10.portfolios· array · requis
2 to 4 portfolios to compare, e.g. [{"template":"all-weather"},{"template":"golden-butterfly"},{"template":"classic-60-40","label":"60/40"}].
Exemple d'appel{"name": "compare_portfolios", "arguments": {"portfolios": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - decompose_factors≈ 1532 tokens
Explain WHAT DRIVES the returns of a ticker, ETF or built-in portfolio by decomposing them into common factor exposures (market, size, value, momentum, quality, low-volatility, duration, credit) plus an idiosyncratic residual. Use this when the user asks why two assets move together, what a fund is really exposed to, whether a stock is a growth or value tilt, how much of a return is just market beta, whether it has real alpha, or what is driving a portfolio's returns. Returns betas (loadings), t-stats, an additive variance decomposition (shares sum to R²), annualized alpha, idiosyncratic vs total volatility, and for a portfolio the holdings that drive each factor. Computed by OLS regression on real price history via tradeable ETF proxies (long-short factor spreads): measured exposure, not a forecast. Provide exactly one of `target` (a ticker, computed live), `template` (a built-in model portfolio), `strategy` (a canonical strategy) or `assets` (your own allocation, including nested portfolios, rotations and strategies as holdings, computed live); portfolio ids are answered from precomputed monthly data through the stated month. Portfolios (ids and `assets`) use the five default factors (market, size, value, duration, credit), are monthly and ignore `frequency` and `factors`. For performance numbers use analyze_portfolio. Read-only.
Paramètres, retour & exemple (9)
Paramètreslabel· string · optionnel
Optional display name for a custom `assets` portfolio. Default "Custom portfolio".assets· array · optionnel
Your own allocation instead of an id, computed live (monthly, default factors; the answer also lists the holdings behind each factor). Same format as analyze_portfolio: plain tickers and nested portfolios, rotations or strategies via `sleeve`. Weights in percent, summing to ~100.target· string · optionnel
Yahoo Finance ticker to decompose, e.g. AAPL, QQQ, TLT, ARKK. Omit when using `template` or `strategy`.factors· array · optionnel
Factor ids to include. Default: MKT, SMB, HML, TERM, CREDIT (long history back to ~2001). All available: MKT, SMB, HML, MOM, QMJ, LOWVOL, TERM, CREDIT. The smart-beta trio (MOM, QMJ, LOWVOL) only has history from ~2011-2013, which shortens the analyzable window — factors without enough overlap are dropped and reported.overlay· object · optionnel
Optional portfolio-level trend-filter overlay applied to the WHOLE book: hold the entire portfolio only while its own level is above its N-month moving average, otherwise cash. Composition is monthly (a 10-month filter ≈ the classic 200-day one).strategy· string · optionnel · dual-momentum-gem | tsmom-sp500 | faber-trend-timing | sector-momentum-rotation | risk-parity-inverse-vol | gtaa-aggressive | adaptive-asset-allocation
Canonical rule-based strategy whose returns to decompose, e.g. dual-momentum-gem. One of: dual-momentum-gem, tsmom-sp500, faber-trend-timing, sector-momentum-rotation, risk-parity-inverse-vol, gtaa-aggressive, adaptive-asset-allocation. Precomputed; default factors.template· string · optionnel · golden-butterfly | all-weather | permanent | dragon | faber-ivy | faber-gaa | bogleheads-3fund | wealthfront-classic
Built-in model portfolio whose returns to decompose, e.g. all-weather. One of: golden-butterfly, all-weather, permanent, dragon, faber-ivy, faber-gaa, bogleheads-3fund, wealthfront-classic, betterment-core, classic-60-40, classic-40-60, swensen, ferri-core-four, couch-potato, coffeehouse, no-brainer, larry, buffett-90-10, total-sp500. Precomputed; default factors.frequency· string · optionnel · 1d | 1wk | 1mo
Return frequency for the regression of a `target` ticker. Monthly (default) is standard for factor analysis. Ignored for `template` / `strategy` (always monthly).rebalance· string · optionnel · none | monthly | quarterly | yearly
Rebalancing cadence for custom portfolios (templates use their own).
Exemple d'appel{"name": "decompose_factors", "arguments": {"label": "texte", "assets": [], "target": "texte", "factors": [], "overlay": {}, "strategy": "dual-momentum-gem"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - find_guides≈ 508 tokens
Search MarketHeist's 90 published research pages and get the page's own verdict and numbers, with its URL to cite: 18 strategy guides (60/40, All Weather, Golden Butterfly, DCA vs lump sum, ...), 26 fund-history pages (how far back an ETF can be tested), 18 trend-filter pages (what a 10-month trend filter did to each portfolio), 16 risk breakdowns (share of risk vs share of money) and 12 rule-robustness pages (does the 200-day average or the golden cross survive other settings, costs and held-out years). Each result returns the title, current verdict, 3-7 headline numbers with the data month, and the last change-log entries. Use it to give a sourced, dated answer to 'does the 200-day average work on SPY', 'would a trend filter have helped All Weather in 2022', 'how far back does VXUS go'. `query` is free words, a ticker or a portfolio name; `slug` returns one page in full (e.g. 'risk/classic-60-40', 'robustness/sma-200-spy'). Read-only and precomputed from the monthly refresh. For live numbers on your own allocation use analyze_portfolio or run_backtest.
Paramètres, retour & exemple (4)
Paramètresset· string · optionnel · any | strategies | history | trend | risk | robustness
Restrict to one page set: strategies, history, trend, risk or robustness. Default any.slug· string · optionnel
Exact page as '<set>/<id>', e.g. 'risk/classic-60-40' or 'robustness/sma-200-spy'. Returns that page in full (every number, labels, change log); `query` is ignored.limit· integer · optionnel
Maximum results for a search (1-10). Default 5.query· string · optionnel
Words, a ticker or a portfolio name, e.g. '200-day SPY', 'all weather trend', 'VXUS', 'golden cross'.
Exemple d'appel{"name": "find_guides", "arguments": {"set": "any", "slug": "texte", "limit": 1, "query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - fund_history≈ 318 tokens
Tell how far back a fund can be tested on MarketHeist once its history is extended with older substitute funds: the proxy chain (e.g. VXUS <- VGTSX), the extended start month, the ETF's own first month and, for the 26 funds with a history page, how closely each stand-in tracked the ETF while both existed (grade close / approximate / stand-in, worst tracking error), the extended-history vs ETF-only CAGR and how many S&P 500 declines the extension adds. Use it for 'can I backtest VXUS to 2000', 'how reliable is the pre-2011 data for BND', before quoting any long-run number for a fund. One `ticker` per call (e.g. VXUS, VTI, TLT, GLD). Read-only and static: no market-data fetch. A ticker with no proxy chain starts at its own inception. For returns of the fund use portfolio_returns; for the rules behind a portfolio's start date use analyze_portfolio.
Paramètres, retour & exemple (1)
Paramètresticker· string · requis
Fund or ETF ticker, e.g. VXUS, VTI, BND, TLT, GLD, DBMF. Case-insensitive; one ticker per call.
Exemple d'appel{"name": "fund_history", "arguments": {"ticker": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_indicators≈ 194 tokens
List the built-in technical indicators available for backtesting (RSI, moving-average crossovers, ADX, Bollinger, CCI, Stochastic, and more) with their IDs, parameters with defaults, and each indicator's default long rule. Call this to answer what strategies or indicators can be tested, or before run_backtest when unsure which indicator_id or parameters to use. Takes no arguments. Read-only and static (no market data is fetched, never rate-limited by the live budget). To find portfolios and strategies instead, use list_portfolios.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_indicators", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_portfolios≈ 433 tokens
List every portfolio and strategy the other tools accept by id, with a one-line description, holdings, headline CAGR / max drawdown / Sharpe with the start month and the data month, and the marketheist.io page and guide URLs. Three kinds: `template` (19 buy-and-hold model portfolios such as classic-60-40, all-weather, golden-butterfly, permanent; used as `template` in analyze_portfolio, portfolio_returns, portfolio_risk, compare_portfolios, decompose_factors), `strategy` (7 rule-based canonical strategies such as dual-momentum-gem and faber-trend-timing; used as `strategy`), and `library_strategy` (19 curated single-asset backtest strategies, usable as holdings via {source:'backtest-public', strategyId} in analyze_portfolio). Call this first when you do not know an id, to avoid guessing. `query` filters by name, id or a holding ticker (e.g. 'gold', 'TLT'). Read-only and precomputed (data through the stated month); the numbers are full-window headline figures over each entry's own start, so use compare_portfolios for a like-for-like comparison.
Paramètres, retour & exemple (2)
Paramètreskind· string · optionnel · all | template | strategy | library_strategy
Which list: template (model portfolios), strategy (canonical rule-based strategies), library_strategy (curated backtest strategies) or all. Default all.query· string · optionnel
Optional filter on name, id, description or a holding ticker, e.g. 'gold', 'momentum', 'TLT'.
Exemple d'appel{"name": "list_portfolios", "arguments": {"kind": "all", "query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - portfolio_returns≈ 1274 tokens
Look up how a portfolio, strategy or fund actually returned: seasonality by calendar month (average return, share of positive months, number of years and a t-statistic so a thin 'September effect' is not presented as a law), calendar-year returns with partial years labelled (optionally next to the S&P 500), trailing 1/3/5/10/20/30-year returns, and the best and worst year and month. Use it for 'is September bad for 60/40', 'what did All Weather return in 2022', 'how has SPY done over 10 years', 'what did my own portfolio return each year'. Pass exactly one of `template` (e.g. all-weather, classic-60-40), `strategy` (e.g. dual-momentum-gem), `ticker` (any Yahoo ticker) or `assets` (your own allocation, including nested portfolios, rotations and strategies as holdings via `sleeve`, with optional `rebalance` and `overlay`); list_portfolios shows every valid id. Built-in ids and the funds with a history page are precomputed from the monthly refresh (instant); other tickers and `assets` are computed live from market data (proxy-extended monthly total returns). Read-only; every answer says which month the data runs through. For risk and drawdowns use portfolio_risk; to compare portfolios use compare_portfolios.
Paramètres, retour & exemple (10)
Paramètreslabel· string · optionnel
Optional display name for a custom `assets` portfolio. Default "Custom portfolio".years· integer · optionnel
Limit the calendar-year table to the most recent N years (e.g. 10). Default: all years.assets· array · optionnel
Your own allocation instead of an id, computed live (monthly composition, proxy-extended). Same format as analyze_portfolio: plain tickers and nested portfolios, rotations or strategies via `sleeve`. Weights in percent, summing to ~100.ticker· string · optionnel
A Yahoo Finance ticker, e.g. SPY, VTI, TLT, AAPL. Funds held by the built-in portfolios or with a history page are precomputed; any other ticker is computed live (proxy-extended where a proxy chain exists).overlay· object · optionnel
Optional portfolio-level trend-filter overlay applied to the WHOLE book: hold the entire portfolio only while its own level is above its N-month moving average, otherwise cash. Composition is monthly (a 10-month filter ≈ the classic 200-day one).sections· array · optionnel
Which tables to return: seasonality, calendar_years, trailing. Default: all three.strategy· string · optionnel
Canonical rule-based strategy id, e.g. 'dual-momentum-gem' or 'faber-trend-timing'. list_portfolios shows all 7.template· string · optionnel
Built-in model portfolio id, e.g. 'all-weather' or 'classic-60-40'. list_portfolios shows all 19.benchmark· string · optionnel · none | sp500
'sp500' adds S&P 500 (SPY, proxy-extended) columns over the same months and the difference. Default sp500.rebalance· string · optionnel · none | monthly | quarterly | yearly
Rebalancing cadence for custom portfolios (templates use their own).
Exemple d'appel{"name": "portfolio_returns", "arguments": {"label": "texte", "years": 1, "assets": [], "ticker": "texte", "overlay": {}, "sections": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - portfolio_risk≈ 1218 tokens
Answer both 'how bad did it get' and 'is it really diversified' for a built-in model portfolio, a canonical strategy or your own portfolio. Drawdowns: the deepest peak-to-trough episodes with months to trough and recovery, Ulcer index, longest time underwater, monthly VaR/CVaR 95, worst month and year, and returns in 2008, 2020 and 2022. Diversification: each holding's share of the risk next to its share of the money (60/40 is about 60% of the money and 93% of the risk), the number of independent bets over the full window, the last 10 years and the 36 months to Feb 2009 and Dec 2022, co-movement groups, near-duplicate pairs and the equal-risk weights. Correlations: the holdings' correlation matrix. Pass exactly one of `template` (e.g. classic-60-40, all-weather), `strategy` (e.g. faber-trend-timing) or `assets` (your own allocation, including nested portfolios, rotations and strategies as holdings via `sleeve`, with optional `rebalance` and `overlay`); list_portfolios shows valid ids. `sections` limits the output. Ids are precomputed from the monthly refresh (instant); `assets` are computed live, with independent bets over the full window (and the last 10 years for plain tickers); the 2008 and 2022 windows are computed for built-in portfolios only. Read-only. For headline CAGR/Sharpe use analyze_portfolio; for calendar returns use portfolio_returns.
Paramètres, retour & exemple (8)
Paramètreslabel· string · optionnel
Optional display name for a custom `assets` portfolio. Default "Custom portfolio".assets· array · optionnel
Your own allocation instead of an id, computed live (drawdowns, risk share, bets and correlations of your own mix). Same format as analyze_portfolio: plain tickers and nested portfolios, rotations or strategies via `sleeve`. Weights in percent, summing to ~100.overlay· object · optionnel
Optional portfolio-level trend-filter overlay applied to the WHOLE book: hold the entire portfolio only while its own level is above its N-month moving average, otherwise cash. Composition is monthly (a 10-month filter ≈ the classic 200-day one).episodes· integer · optionnel
How many of the deepest drawdown episodes to list (1-8). Default 5.sections· array · optionnel
Which parts to return: drawdowns, diversification, correlations. Default: all three.strategy· string · optionnel
Canonical rule-based strategy id, e.g. 'faber-trend-timing'. A strategy is one rule-based line, so its diversification section is reported as not applicable.template· string · optionnel
Built-in model portfolio id, e.g. 'classic-60-40', 'all-weather', 'golden-butterfly'. list_portfolios shows all 19.rebalance· string · optionnel · none | monthly | quarterly | yearly
Rebalancing cadence for custom portfolios (templates use their own).
Exemple d'appel{"name": "portfolio_risk", "arguments": {"label": "texte", "assets": [], "overlay": {}, "episodes": 1, "sections": [], "strategy": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - run_backtest≈ 1138 tokens
Backtest a trading strategy on any Yahoo Finance ticker and get authoritative performance metrics computed from real historical price data — not estimated. Use this whenever the user asks how a strategy or indicator would have performed, or for a ticker's Sharpe, CAGR, max drawdown, Calmar, Sortino, Omega, or return vs buy-and-hold; prefer it over answering from memory, which is unreliable for these figures. Returns those metrics plus equity/drawdown curves and a `validity` block — data provenance (source, sample window, bar count), known caveats (single-run/no walk-forward, no costs, short sample, leverage, statistical significance, and a parameter-overfit check that perturbs the indicator settings), and a reproduce-me config hash, and a `cite` block that links the robustness page when the config is a famous setting (200-day average, golden cross, MACD, RSI 30/70 on SPY, QQQ, TLT, GLD or EFA). Surface the caveats when reporting results. Always pass execution_delay=1 to avoid lookahead bias. Call list_indicators first if unsure which indicator_id to use. Single asset only: for allocations use analyze_portfolio. Read-only; live market data, so heavy callers can hit the daily live-data limit.
Paramètres, retour & exemple (20)
Paramètresticker· string · requis
Yahoo Finance ticker symbol (e.g. AAPL, ^NDX, BTC-USD, SPY).lookback· integer · optionnel
Rolling window for position_rule_type=percentile.direction· string · optionnel · above | below
Long when indicator is above (or below) threshold/MA/percentile.frequency· string · optionnel · 1d | 1wk | 1mo
Bar frequency. Default: 1wk.ma_window· integer · optionnel
MA window for position_rule_type=crossover.target_dd· number · optionnel
Target max drawdown (negative decimal) for leverage_mode=target_dd. E.g. -0.40.threshold· number · optionnel
Fixed threshold for position_rule_type=threshold. E.g. 50 for RSI, 1.0 for MA Crossover. Omit to use the indicator's default rule (the 'Default rule' list_indicators shows; e.g. RSI: above 50).atr_period· integer · optionnel
ATR period for regime_filter_type=volatility.percentile· number · optionnel
Percentile rank threshold (0–100) for position_rule_type=percentile.sma_window· integer · optionnel
SMA window for regime_filter_type=trend. Classic: 200.target_vol· number · optionnel
Target annualized vol (decimal) for leverage_mode=target_vol. E.g. 0.15 = 15%.max_atr_pct· number · optionnel
ATR% threshold for regime_filter_type=volatility.indicator_id· string · requis
Built-in indicator id. Call list_indicators to see all options. Common: rsi, bollinger, ma_crossover, ema_crossover, adx, cci, stochastic.leverage_mode· string · optionnel · none | fixed | target_vol | target_dd
none=1×. fixed=constant multiplier. target_vol=scale to vol target. target_dd=scale to drawdown target.leverage_value· number · optionnel
Multiplier for leverage_mode=fixed. E.g. 2.0 = 2×.execution_delay· integer · optionnel
Bars of delay between signal and execution. Use 1 to avoid lookahead bias.indicator_params· string · optionnel
Indicator parameters as a JSON string. E.g. '{"period":14}' for RSI. Omit to use defaults.position_rule_type· string · optionnel · threshold | crossover | percentile
threshold: long when value is above/below a fixed level. crossover: long when value is above its own MA. percentile: long when value is above its rolling percentile.regime_filter_type· string · optionnel · none | trend | volatility
trend: only hold when close > SMA(sma_window). volatility: only hold when ATR% < max_atr_pct.transaction_costs_bps· number · optionnel
One-way transaction cost in basis points (1 bps = 0.01%).
Exemple d'appel{"name": "run_backtest", "arguments": {"ticker": "texte", "indicator_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».