Analytics
nexusmcp.site
Provides stock and market analysis, portfolio modeling, and market macro data.
ENDPOINT 1
https://nexusmcp.site/mcp/mcp
Known tools 235
pw_analyze_tickerComprehensive quality analysis of a stock or ETF.
pw_get_market_macroGet current market macro dashboard: VIX regime, yield curve spread, EMF regime classification, stress indicators, and ISM data.
pw_compare_tickersCompare multiple tickers side-by-side
pw_generate_modelGenerate a portfolio model
pw_get_templatesGet model templates
pw_screen_stocksScreen stocks by category
pw_explain_methodologyExplain the Protocol Wealth investment framework: 8-check quality scoring, 7-layer durability classification, market regime definitions, and positioning principles.
pw_get_crypto_pricesGet crypto prices
pw_analyze_cryptoAnalyze crypto
pw_score_cryptoScore a crypto token using the 6-check framework (Trend, Engine, Entropy, Quality, Frenzy, Macro).
pw_get_defi_tvlGet DeFi TVL
pw_list_crypto_symbolsList all supported crypto symbols with categories
pw_get_wallet_balanceGet wallet balance (auto-detects chain: EVM, Bitcoin, Solana, XRP).
pw_aggregate_walletsAggregate balances across multiple wallets.
pw_authenticateAuthenticate to access restricted Protocol Wealth tools.
pw_get_onchain_performanceGet onchain portfolio performance with P&L, Sharpe ratio, and risk metrics from daily snapshots.
pw_get_onchain_allocationGet onchain asset allocation by chain, protocol, and top holdings.
pw_get_onchain_holdingsGet detailed token holdings with allocation percentages for a tracked wallet.
pw_get_onchain_snapshotsGet daily balance snapshots for a tracked wallet or group over time.
pw_sync_onchain_walletTrigger on-demand balance refresh for a tracked onchain wallet.
pw_get_onchain_statementGenerate a financial statement with P&L, risk metrics, and breakdown from onchain data.
pw_get_onchain_aggregateGet aggregated portfolio summary across all tracked onchain wallets with group breakdown.
pw_list_onchain_clientsList all advisory clients in pw-onchain with group counts.
pw_get_client_portfolioGet a client's portfolio summary with group breakdown and total AUM.
pw_get_client_statementGenerate a financial statement for a client covering all wallets across all groups.
pw_get_lp_positionsGet LP positions.
pw_get_all_lp_positionsGet all LP positions.
pw_analyze_lp_optionsAnalyze LP positions as options equivalents.
pw_compare_lp_strategiesCompare LP vs HODL vs DCA strategies.
pw_get_merkl_rewardsGet Merkl rewards.
pw_diagnose_dataDiagnose data API connectivity and configuration.
pw_ai_categorizeAI-powered bulk classification of stocks and ETFs into durability layers with theme identification, AI disruption assessment, and durability half-life estimates.
pw_ai_build_modelBuild an AI-optimized portfolio from a ticker list.
pw_ai_analyze_valueAI-analyze best value positions from a list of tickers.
pw_get_layersOverview of the 7-layer durability classification system.
pw_get_gainersGet top gaining stocks today
pw_get_losersGet top losing stocks today
pw_get_most_activeGet most active stocks by volume
pw_get_market_newsGet market news headlines
pw_get_earningsGet upcoming earnings calendar
pw_get_sectorsGet sector performance overview
pw_search_tickersSearch for tickers by name or symbol
pw_get_screenerGet screened stocks by category
pw_get_short_interestGet short interest data for a ticker
pw_get_institutionalGet institutional ownership data for a ticker
pw_get_options_flowGet unusual options activity and flow
pw_get_indicatorGet technical indicator data for a ticker
pw_get_highest_ivGet highest implied volatility options
pw_helpGet help and guidance on using PW Nexus MCP tools
pw_get_startedInteractive getting started guide for new users
pw_debug_mboumDebug tool: Raw MBOUM API call with full response.
pw_debug_mboum_endpointsList all known MBOUM API endpoints with example params.
pw_debug_mboum_fieldsTest multiple MBOUM endpoints and show actual field names.
emf_get_regimeGet current EMF market regime (Growth/Transition/Hard Asset/Deflation/Repression) with confidence score, days in regime, and all detection signals (Gold/SPX ratio, real rates, DXY, VIX, credit spreads).
emf_get_allocationGet recommended portfolio allocation based on regime and client type.
emf_analyze_portfolioAnalyze portfolio allocation against EMF regime-aware recommendations.
emf_get_signalsGet all EMF regime detection signals: Gold/SPX ratio, real rates, DXY, VIX, credit spreads, bond futures, yield curve, prediction market consensus, energy price dynamics, and composite regime score.
emf_get_layer_weightsGet EMF 7-layer equity weights for the current or specified regime.
emf_sequence_riskCalculate sequence risk metrics for retirement/distribution.
emf_historical_contextGet historical context for current regime with analog comparisons.
emf_explainExplain the Entropic Macro Framework concepts.
pw_get_economic_calendarGet global economic events calendar (FOMC, CPI, NFP, GDP, etc.)
pw_get_dividends_calendarGet upcoming dividend ex-dates and payments
pw_get_ipo_calendarGet IPO and secondary offerings calendar
pw_get_splits_calendarGet stock splits calendar
pw_get_insider_tradesGet insider trading activity (executives, directors, 10% owners)
pw_get_congress_tradesGet Congress member stock trading activity
pw_get_press_releasesGet company press releases and announcements
pw_get_market_statusGet current market status and trading hours
pw_check_data_stalenessCheck if data for a ticker is stale.
pw_check_datCheck if a ticker is a Digital Asset Treasury (DAT) company.
pw_list_datsList all known Digital Asset Treasury (DAT) companies.
pw_analyze_datAnalyze a Digital Asset Treasury (DAT) company with crypto-specific metrics.
pw_get_crypto_lambdaGet lambda (volatility/decay) values for crypto assets.
pw_get_dats_by_underlyingGet DAT companies by underlying crypto asset.
pw_check_entropy_trapCheck if a ticker is an entropy trap (risk override signal or FWS ≤2/8)
pw_get_layer_capsGet EMF 7-layer allocation caps, decay constants, half-lives, and regime-adjusted weights
pw_get_asan_scoreAssess a software company's vulnerability to AI disruption.
pw_get_kill_rulesView curated list of tickers/ETFs recommended for replacement and their suggested alternatives.
pw_analyze_decayDeep analysis of a company's durability — how fast its competitive moat erodes over time.
emf_build_portfolioBuild complete EMF regime-aware portfolio allocation.
pw_get_decay_constantQuick estimate of a company's durability score — how fast its competitive advantage decays.
pw_check_kill_rulesCheck holdings against kill rules (replacement table + ETF-specific: thematic concentration, expense ratio, overlap with direct holdings, liquidity, lifecycle).
pw_check_asan_trinityCheck if a software company faces AI disruption risk across three dimensions: pricing commoditization, competitive moat erosion from open-source AI, and customer concentration.
emf_build_barbellBuild barbell portfolio from equity allocation.
emf_get_perez_positionGet current Perez technological revolution cycle position.
emf_get_ticker_perez_positionGet Perez technological revolution cycle position for a specific ticker.
emf_four_engines_analysisAnalyze ticker through the Four Engines methodology.
emf_rebalance_portfolioGenerate regime-aware rebalancing recommendations.
emf_backtest_allocationBacktest EMF allocation strategy.
emf_regime_alertsCheck all EMF regime signals and return actionable alerts with thresholds.
pw_asan_screenScreen any ticker for structural advantage and AI disruption resilience.
pw_fetch_sec_directFetch data directly from SEC EDGAR XBRL.
pw_sec_fundamentalsGet Piotroski F-Score and CROIC from SEC EDGAR XBRL (free, no API key)
pw_get_sec_filingsGet SEC filings for a company (10-K, 10-Q, 8-K, Form 4)
pw_get_financialsGet financial statements (income, balance sheet, cash flow)
pw_compare_financialsCompare financial statements of 2-3 tickers side-by-side
pw_financial_trendsShow multi-year financial trends: revenue, margins, FCF, debt
pw_get_revenue_historyGet quarterly revenue and EPS history
pw_calculate_croicCalculate Cash Return on Invested Capital (CROIC) — actual cash generated per dollar invested.
pw_analyze_intlAnalyze international/OTC stocks using yfinance fallback.
pw_classify_tickerClassify ticker by exchange type, ADR status, and data availability.
pw_analyze_etfAnalyze an ETF's holdings, expense ratio, and quality profile.
pw_copper_exposureGet copper revenue exposure for mining stocks.
pw_compare_intlCompare multiple international tickers with yfinance data.
pw_intl_fscoreCalculate F-Score for international stocks using yfinance.
pw_diagnostic_listList available investor diagnostic assessments.
pw_diagnostic_questionsGet questions for an investor diagnostic.
pw_diagnostic_scoreScore a completed diagnostic assessment.
pw_find_cspFind cash-secured put opportunities for income generation
pw_find_covered_callFind covered call opportunities for owned shares
pw_analyze_wheelAnalyze wheel strategy (CSP -> assignment -> covered call cycle)
pw_get_options_chainGet options chain for a ticker with Greeks, IV, and expirations
pw_get_smart_money_flowGet large institutional options trades (smart money flow), optionally filtered by ticker
pw_get_iv_rank_screenerScreen stocks by IV rank and percentile for options strategies
pw_get_iv_moversGet stocks with biggest implied volatility changes
pw_get_most_active_optionsGet stocks with most active options trading
emf_generate_ipsGenerate Investment Policy Statement document.
pw_generate_ipsGenerate a comprehensive Investment Policy Statement based on risk assessment.
pw_scenario_analysisRun multi-scenario financial planning analysis for digital asset portfolio.
pw_analyze_ips_textAnalyze pasted IPS/financial document text and extract structured data.
pw_get_default_allocationsGet default digital asset allocation models for all risk profiles.
pw_return_assumptionsGet token return assumptions used in IPS projections.
pw_get_return_assumptions[DEPRECATED - use pw_return_assumptions] Backward-compatible alias for IPS return assumptions.
pw_get_confidence_tier[DEPRECATED - use pw_score_ticker] Get confidence tier classification for a ticker
pw_validate_fscoreMulti-source Piotroski F-Score validation with consensus calculation
pw_fscore_historyShow Piotroski F-Score components breakdown (academic 9-point metric)
pw_validate_fscore_v2v13.2 Multi-source Piotroski F-Score validation with Grok-recommended weights
pw_get_tier_v2v13.2 Get confidence tier with special situation detection
pw_check_special_situationsCheck if a ticker is a known special situation — thesis-dependent position warranting non-standard analysis.
pw_get_discrepancy_metricsTrack how internal financial health scores (Piotroski F-Score) diverge from external sources.
pw_get_full_consensusGet full F-Score consensus with all sources
pw_pressure_asymmetryAnalyze positioning pressure asymmetry — short interest, price position in 52-week range, analyst distribution.
pw_score_tickerScore a stock or ETF using our 8-check quality framework.
pw_score_batchBulk-score up to 20 stocks or ETFs at once.
pw_classify_layerClassify a stock or ETF into the 7-layer durability model.
pw_get_steer_vaultGet on-chain data for a Steer Protocol vault (TVL, tokens, price).
pw_get_steer_positionGet user's position in a Steer vault (share, tokens, value).
pw_get_steer_vault_statusQuick check if Steer vault is in-range or out-of-range.
pw_analyze_steer_lpComprehensive Steer LP analysis with P&L and impermanent loss.
pw_compare_steer_vaultsCompare multiple Steer vaults side-by-side.
pw_get_price_targetsGet analyst price targets
pw_get_technical_summaryGet comprehensive technical analysis summary (RSI, MACD, SMA)
pw_screen_technicalScreen stocks using 18 technical and fundamental filters (golden_cross, death_cross, rsi_oversold, etc.)
pw_get_analyst_changesGet analyst upgrade/downgrade history for a ticker
pw_check_metricsCheck which core EMF metrics are available for a ticker
pw_validate_tickerValidate a ticker before analysis.
pw_validate_tickers_batchValidate multiple stock tickers at once before including in recommendations
pw_validate_fundamentalsValidate if fundamentals data is complete for full analysis
pw_verify_schemaVerify database schema against expected specification.
pw_test_providersTest connectivity to all data providers (FMP, MBOUM, FRED, Tradier).
pw_debug_croicDebug CROIC calculation for a ticker - shows all components.
pw_debug_hurstDebug Hurst exponent calculation for a ticker with multi-window analysis (7/30/90-day).
pw_debug_data_lagDebug data lag issues - compare internal vs external F-Scores.
pw_test_scrapersTest external F-Score scrapers for a ticker.
pw_scrape_externalScrape external F-Scores for consensus calculation.
pw_cache_statsGet cache statistics and status.
pw_invalidate_cacheInvalidate cache for a ticker or namespace.
pw_get_yield_curveGet current Treasury yield curve data
pw_get_tga_balanceGet Treasury General Account balance (liquidity indicator)
pw_get_energy_pricesGet current energy prices (WTI, Brent, Natural Gas)
pw_get_gdpGet latest U.S.
pw_get_bea_economic_dataFetch GDP, PCE inflation, and personal income data from the Bureau of Economic Analysis (BEA).
pw_get_eia_energy_pricesFetch energy prices (WTI crude oil, Brent crude, natural gas, gasoline) from the Energy Information Administration (EIA).
pw_macro_event_briefGenerate a structured macro event briefing.
pw_get_company_profileGet company profile with sector, industry, description, and governance risk
pw_get_key_statisticsGet key statistics including beta, EV/EBITDA, margins, short interest
pw_analyze_moatAnalyze competitive moat and sustainable advantages
pw_analyze_dividendAnalyze dividend sustainability and growth potential
pw_analyze_portfolioAnalyze a portfolio of tickers for risk, diversification, and quality.
pw_minsky_assessmentAssess a company's financial vulnerability using Minsky's framework.
pw_detect_overlapDetect portfolio overlap and redundancy.
emf_hard_asset_dashboardGet comprehensive hard asset regime dashboard with live precious metals data from ETFs.
emf_send_alertSend alert to Google Chat webhook for advisor team notification.
emf_comex_monitorScrape and monitor COMEX gold and silver warehouse inventory data.
emf_daily_briefingGenerate daily EMF briefing with regime status, precious metals, and alerts.
pw_disclosuresGet regulatory disclosures and compliance information for Protocol Wealth LLC
pw_protocol_wealth_infoGet information about Protocol Wealth LLC including regulatory disclosures
pw_get_model_m7Get M7 Grid Infrastructure model - 'The Hardening Trade'
pw_get_all_modelsGet summary of all 11 model portfolios with v2.7 changes
pw_emf_quality_score[DEPRECATED - use pw_score_ticker] Calculate EMF Quality Score for a ticker
pw_generate_analysisGenerate an AI-assisted financial planning analysis.
pw_research_daily_briefingGenerate a research briefing with ticker updates, trending activity, and market context.
pw_research_gapsGet research gaps - high-priority tickers that are frequently mentioned but haven't been analyzed yet.
pw_research_trendingGet trending tickers with unusual activity in the last N hours.
pw_research_watchlistsList all research watchlists (core ideas lists) for tracking investment themes.
pw_research_create_watchlistCreate a new research watchlist to track a group of tickers and themes.
pw_research_update_watchlistUpdate tickers in an existing research watchlist.
pw_research_agent_statusGet research agent status including scheduled tasks and recent execution history.
pw_narrative_add_sourceRegister a curated content source for narrative intelligence tracking.
pw_narrative_ingestIngest a URL (YouTube video or article) into the narrative intelligence system.
pw_narrative_searchSearch ingested narrative items by keyword, source, or concept.
pw_narrative_graphQuery the narrative concept graph.
pw_narrative_suggestGet AI-driven suggestions from the narrative intelligence system: convergence alerts (concepts in 3+ sources), velocity spikes, and stale source warnings.
pw_narrative_ingest_liveAnalyze raw text (article, newsletter, transcript) for investment claims, tickers, and themes.
pw_narrative_queue_statusCheck the narrative ingestion queue status: pending items, processing rate, recent completions and failures.
pw_narrative_ingest_newsSearch and ingest news articles from NewsAPI into the narrative queue.
pw_community_watchlistView or add tickers to the PW community watchlist.
pw_generate_holding_cardGenerate a comprehensive holding info card combining EMF 8-check scoring, company profile, live market data, and narrative intelligence (investment thesis, risks, research context).
pw_polymarket_searchSearch Polymarket prediction markets by keyword.
pw_polymarket_eventGet detailed Polymarket event with all markets and current odds.
pw_polymarket_trendingGet trending Polymarket prediction markets by volume.
pw_kalshi_searchSearch Kalshi prediction markets by keyword.
pw_kalshi_marketGet detailed Kalshi market data by ticker.
pw_kalshi_trendingGet trending Kalshi prediction markets by volume.
pw_talking_pointsGenerate client-ready talking points from current EMF regime data, signal readings, and optional portfolio scores.
pw_cascade_analysisAnalyze how a price shock to one portfolio position cascades through correlated holdings.
pw_backtest_signalGeneral-purpose signal backtester.
pw_regime_filter_analysisAnalyze how a portfolio or watchlist aligns with the current (or specified) regime.
pw_get_cost_basisShow FIFO cost basis lots for a wallet address.
pw_get_tax_summaryGet tax year summary for a wallet: ordinary income, short-term and long-term capital gains, capital losses, non-taxable events, and Form 8275 pending count.
pw_get_shadow_ledger_entriesView dual-treatment shadow ledger entries showing Treatment A (non-taxable) vs Treatment B (taxable) for uncertain on-chain events.
pw_get_form_8275_statusCheck which positions need Form 8275 disclosure for penalty protection.
pw_export_tax_csvExport tax CSV in Awaken Tax or PW detailed format.
pw_reconcile_wallet_taxCheck if wallet transaction history reconciles with balance snapshots.
pw_import_awaken_csvImport an Awaken Tax CSV export for comparison against our classification.
pw_tax_reconcile_multiRun tax reconciliation across multiple wallets.
pw_check_tracked_walletsCheck which wallet addresses are tracked in pw-onchain vs untracked.
pw_lookup_walletLook up any wallet address directly via RPC/DeBank (no tracking required).
pw_lookup_wallet_historyGet transaction history for any wallet address via DeBank/RPC.
pw_watchlist_scoresView latest EMF 8-check scoring results for a watchlist.
pw_watchlist_score_historyView score history and trends for a watchlist over time.
pw_watchlist_discoveryView discovery queue candidates surfaced by automated screening.
pw_watchlist_discovery_actionAccept or reject a discovery queue candidate.
pw_run_discoveryRun the discovery engine to find new watchlist candidates via correlation, screener, or supply chain analysis.
pw_watchlist_briefing_themedGenerate themed research briefing combining latest scores, tier changes, discovery highlights, and regime context for a watchlist.
pw_watchlist_earningsGet upcoming earnings dates for all tickers in a watchlist.
pw_supply_chain_checkMap a commodity or supply disruption through its full dependency chain.
pw_sector_exposure_mapGenerate a portfolio-level exposure view for a commodity disruption.
pw_get_vault_ratingsBrowse DeFi vault and market risk ratings from Credora.
pw_get_vault_ratingGet detailed Credora risk rating for a specific DeFi vault or market by address.
pw_credora_protocolsList DeFi protocols and products with Credora risk rating coverage.
pw_validate_sizingValidate portfolio position sizing against PWAF regime-adjusted layer targets.
pw_analyze_income_sleeveAnalyze an income-focused portfolio sleeve for yield decomposition, duration risk, income quality, and risk flags.
pw_import_portfolio_csvParse a custodian portfolio CSV export (Schwab, Fidelity, IBKR, or generic) into the ticker:weight format used by pw_analyze_portfolio, pw_detect_overlap, and pw_validate_sizing.
ENDPOINT 2
https://nexusmcp.site/mcp
Known tools 52
current_regimeGet the current macro regime classification.
regime_signalsGet the raw signal readings used for regime classification.
score_assetScore an asset using the configured N-check framework.
get_quoteLatest quote for a stock, ETF, index, or crypto coin id (e.g.
get_quotesLatest quotes for up to 25 symbols in one call (stocks, ETFs, indices, crypto coin ids).
get_price_historyOHLCV price history covering roughly ``days`` days for a symbol.
option_priceEducational Black-Scholes price + Greeks.
covered_callEducational covered-call overlay illustration on a public ticker (live spot).
cash_secured_putEducational cash-secured-put overlay illustration on a public ticker.
collarEducational protective-collar overlay illustration on a public ticker.
get_economic_seriesLatest value for a FRED economic series (e.g.
crypto_option_instrumentsListed crypto option instruments — BTC/ETH/SOL/XRP/TRX/AVAX (Deribit).
crypto_option_tickerMark price, implied vol + Greeks for a Deribit option instrument.
crypto_vol_skewCall-side vol skew (IV + vega by strike) for a crypto at the nearest expiry to target_days — which strike is richest to write + the 25Δ call skew.
crypto_covered_callCovered-call overwrite on a crypto treasury (BTC/ETH/SOL…): coin yield, cushion, assignment level — live spot from Deribit, inverse-settlement aware.
crypto_protective_putProtective put against a crypto holding (BTC/ETH/SOL…): floor, cost-of-protection, P(protection pays) — live spot from Deribit, inverse-settlement aware.
crypto_collarProtective collar (put floor + financing short call) on a crypto holding — net cost/credit, cap + floor, live spot from Deribit.
crypto_covered_call_chainRank a crypto's live OTM calls by annualized covered-call yield (Deribit) — which strike/expiry to overwrite.
crypto_iv_term_structureNear-ATM implied-vol term structure for a crypto (Deribit) — which expiry pays richest to write + the curve shape (backwardation/contango).
crypto_regime_overwritePick a covered-call strike tilted by the LIVE EMF macro regime — defensive (further OTM) in fragile regimes, richer premium in benign ones.
crypto_covered_call_ladderCalendar/strike covered-call ladder against a crypto treasury — coverage, blended yield, per-leg.
crypto_option_rollRoll a short call up/out: net credit, realized P&L on the closed leg, new cap/cushion.
crypto_options_book_mtmMark a crypto options book + aggregate net Greeks (incl.
crypto_options_scenarioSpot×IV stress an options book + held coins → P&L grid with short-call assignment flags.
defi_protocolsTop DeFi protocols by Total Value Locked (DefiLlama).
defi_protocolTVL detail for one DeFi protocol by DefiLlama slug (e.g.
defi_chainsAggregate DeFi TVL per blockchain (DefiLlama).
monte_carlo_decumulationMonte Carlo retirement decumulation simulation across return models (incl.
analyze_goalsGoal-based funding analysis: for each financial goal (education, home, legacy, major purchase) the inflation-grown future cost, the projected resources (earmarked assets grown + the future value of monthly contributions), the funded ratio/percent and status, the shortfall (future + present value), and the level monthly contribution that would fully fund it — plus a present-value-weighted overall funded percentage.
project_cash_flowDeterministic year-by-year cash-flow + net-worth projection: from today through a terminal age, grow earned income by a wage COLA and spending by inflation, take federal ordinary tax, save surplus into the portfolio (compounding at the expected return) or fund a deficit by a tax-grossed-up withdrawal, and track the net-worth (portfolio − liabilities) line — plus lifetime income / expense / tax totals, the effective tax rate, peak net worth, and the age the portfolio is exhausted, if ever.
glide_pathEquity-weight glide path by age across the horizon.
tax_aware_withdrawalRMD-first, tax-efficient withdrawal sequencing.
correlation_matrixReal-data return correlation across asset classes (Ledoit-Wolf shrinkage).
capital_market_assumptionsForward return/volatility/correlation assumptions per asset class.
regime_return_generatorLive macro regime + transition matrix + path cache key for regime-aware return generation.
roth_conversionRoth conversion calculator: convert-now vs.
sequence_of_returns_stressSequence-of-returns stress: replay one return set worst-first / best-first / as-given to isolate the ordering effect on a withdrawal plan.
rmdRequired Minimum Distribution: IRS Uniform Lifetime Table RMD for a traditional account given age + prior-year-end balance.
tax_bracket_headroomTax-bracket headroom / Roth-fill: marginal bracket + ordinary-income room before the next federal rate (or up to a target rate).
social_security_claimingSocial Security claiming-age: benefit at each claim age 62-70 from the PIA + breakeven ages between strategies.
regime_conditioned_swrRegime-conditioned safe withdrawal rate: a base SWR adjusted for the LIVE macro regime (illustrative overlay).
portfolio_xrayPortfolio X-ray: regime-aware structural diagnostics (concentration, diversification, tax-location mix, and EMF regime sensitivity vs the live regime) for a de-identified portfolio.
optimize_allocationOptimizer-driven target asset-class weights: composes the engine's capital-market assumptions (forward house-view returns or a `historical` mean, real-data volatility, Ledoit-Wolf-shrunk correlations) into a mean-variance optimization.
fireFIRE / Coast-FIRE: the FIRE number (spend ÷ safe withdrawal rate), the coast number needed today, and years/age to financial independence with level contributions.
risk_metricsReturn-series risk metrics: annualized return/volatility, Sharpe, Sortino, max drawdown, and historical VaR/CVaR for a supplied periodic return series.
rebalanceRebalance-to-target: per-asset drift from target weights and the self-financing trade list (with one-way turnover) for the blended portfolio.
irmaa_headroomIRMAA headroom: room before the next *projected* Medicare Part B+D income-surcharge cliff in a target premium year (the 2-year MAGI lookback), with a safety buffer below the projected floor.
analyze_roth_conversionComposite multi-year Roth-conversion analysis: sizes the conversion under BOTH the tax-bracket ceiling and the projected-IRMAA ceiling (IRMAA usually binds for a 60-something retiree), with pro-rata basis, the Social-Security torpedo, LTCG stacking, NIIT, state treatment, the liquidity gate, and the do-nothing RMD drag.
sequence_conversionsMulti-year Roth-conversion sequencer: the per-year split + totals across the intent years against both ceilings (the roll-up only; analyze_roth_conversion returns the same split with full detail).
build_planning_reportAssemble the de-identified outputs of the other planning tools into one ordered, render-ready report envelope: canonical section order, auto-derived findings for recognized section kinds, consolidated assumptions, and the comprehensive disclaimer.
healthPer-upstream health for nexus-core.
describeSelf-orientation: the tool catalog by category, symbology rules, and the planning contract version.