{
  "schema_version": "v1",
  "name": "Pinnacle Wealth Advisory WebMCP Suite",
  "description": "Institutional private wealth advisory tools for estate tax calculation, 401(k) tax drag, IRC §162 executive bonus, buy-sell audits, Tier-1 carrier solvency, encrypted vault queries, and executive brief generation.",
  "vendor": "Pinnacle Wealth Advisory",
  "homepage": "https://pinnacle.wagents.app",
  "tools": [
    {
      "name": "calculate_financial_health",
      "description": "Calculates Point A Financial Health Diagnostic score (0-100), Debt-to-Income (DTI) ratio, and monthly surplus capacity.",
      "parameters": {
        "type": "object",
        "properties": {
          "clientAge": { "type": "number", "description": "Client age in years" },
          "clientAnnualIncome": { "type": "number", "description": "Gross annual household income" },
          "expectedRetirementAge": { "type": "number", "description": "Target retirement age" },
          "monthlyLivingExpenses": { "type": "number", "description": "Core monthly nondiscretionary expenses" },
          "mortgageMonthly": { "type": "number", "description": "Monthly mortgage or rent payment" },
          "creditCardBalance": { "type": "number", "description": "Outstanding revolving consumer debt" }
        },
        "required": ["clientAge", "clientAnnualIncome"]
      }
    },
    {
      "name": "simulate_wealth_strategy",
      "description": "Simulates Point B wealth accumulation under Tier-1 Institutional Max-Accumulator IUL, projected tax-free retirement draws, and contractual 0% floor downside protection.",
      "parameters": {
        "type": "object",
        "properties": {
          "currentAge": { "type": "number", "description": "Starting age for strategy" },
          "targetRetirementAge": { "type": "number", "description": "Age when tax-free income begins" },
          "annualPremium": { "type": "number", "description": "Annual funding amount" },
          "fundingYears": { "type": "number", "description": "Number of contribution years (typically 10-20)" },
          "marketScenario": { "type": "string", "enum": ["historical-sp500", "stagflation-1970s", "dotcom-crash", "gfc-2008"], "description": "Historical stress-test scenario" }
        },
        "required": ["currentAge", "targetRetirementAge", "annualPremium"]
      }
    },
    {
      "name": "get_active_strategy_state",
      "description": "Retrieves the active client session state, diagnostic inputs, health score, and strategy simulation parameters.",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "update_strategy_parameters",
      "description": "Updates client parameters (age, retirement age, annual savings) directly in the active browser session.",
      "parameters": {
        "type": "object",
        "properties": {
          "clientAge": { "type": "number", "description": "Updated client age" },
          "expectedRetirementAge": { "type": "number", "description": "Updated target retirement age" },
          "annualSavings": { "type": "number", "description": "Updated annual savings capacity" }
        }
      }
    },
    {
      "name": "calculate_estate_tax_exposure",
      "description": "Evaluates 2026 TCJA sunset estate tax liability ($13.61M down to ~$7M), computing federal 40% tax drag and required Irrevocable Life Insurance Trust (ILIT) liquidity.",
      "parameters": {
        "type": "object",
        "properties": {
          "grossEstateValue": { "type": "number", "description": "Total gross estate valuation in USD" },
          "isMarried": { "type": "boolean", "description": "Whether client is married (eligible for DSUE portability)" },
          "hasExistingILIT": { "type": "boolean", "description": "Whether an ILIT is already in place" }
        },
        "required": ["grossEstateValue"]
      }
    },
    {
      "name": "compare_401k_vs_iul_tax_drag",
      "description": "Compares traditional 401(k)/IRA ordinary income tax drag, RMD forced distributions at age 73/75, and IRMAA Medicare surcharges vs IRC §7702 tax-free policy loans.",
      "parameters": {
        "type": "object",
        "properties": {
          "annualContribution": { "type": "number", "description": "Annual contribution to 401(k) / IUL" },
          "yearsToRetire": { "type": "number", "description": "Years remaining until retirement" },
          "retirementAnnualDistribution": { "type": "number", "description": "Desired annual retirement draw" },
          "projectedTaxBracket": { "type": "number", "description": "Projected marginal tax bracket (e.g. 0.37)" }
        },
        "required": ["annualContribution", "yearsToRetire"]
      }
    },
    {
      "name": "model_executive_bonus_split_dollar",
      "description": "Models an IRC §162(a)(1) executive retention bonus ('Golden Handcuffs') with corporate tax deductions and Restrictive Endorsement Agreements (REA).",
      "parameters": {
        "type": "object",
        "properties": {
          "annualBonusAmount": { "type": "number", "description": "Annual executive bonus allocation" },
          "retentionYears": { "type": "number", "description": "Vesting cliff duration in years" },
          "corporateTaxRate": { "type": "number", "description": "Corporate marginal tax rate (default 0.21)" }
        },
        "required": ["annualBonusAmount"]
      }
    },
    {
      "name": "audit_buy_sell_agreement",
      "description": "Audits cross-purchase vs entity redemption buy-sell agreements, evaluating partner count, step-up in basis under IRC §1014, and liquidity shortfall.",
      "parameters": {
        "type": "object",
        "properties": {
          "businessValuation": { "type": "number", "description": "Total fair market enterprise valuation" },
          "numberOfOwners": { "type": "number", "description": "Number of equity principals" },
          "existingInsuranceFunding": { "type": "number", "description": "Current insurance funding in force" },
          "agreementType": { "type": "string", "enum": ["cross_purchase", "entity_purchase", "wait_and_see"] }
        },
        "required": ["businessValuation"]
      }
    },
    {
      "name": "audit_carrier_solvency",
      "description": "Analyzes Tier-1 institutional carrier financial strength, including Comdex 93 composite score, S&P AA-, A.M. Best A+, RBC ratio (415%), and unbroken dividend records.",
      "parameters": {
        "type": "object",
        "properties": {
          "carrierName": { "type": "string", "description": "Name of carrier to audit (e.g. Pacific Life, Penn Mutual, MassMutual)" }
        }
      }
    },
    {
      "name": "query_vault_documents",
      "description": "Queries simulated AES-256 GCM client stewardship vault records (Trust Agreements, K-1s, 7702 Actuarial Ledgers) with SHA-256 integrity hashes.",
      "parameters": {
        "type": "object",
        "properties": {
          "searchCategory": { "type": "string", "description": "Category filter: 'estate', 'policy', 'tax', 'all'" },
          "includeMetadata": { "type": "boolean", "description": "Include SHA-256 hash and classification" }
        }
      }
    },
    {
      "name": "generate_cpa_annual_audit_pack",
      "description": "Synthesizes an annual CPA tax compliance and 7702 reconciliation workpaper (Non-MEC 7-Pay verification, Form 1099-R exempt status).",
      "parameters": {
        "type": "object",
        "properties": {
          "taxYear": { "type": "number", "description": "Tax year for compliance audit (e.g. 2025, 2026)" },
          "includeActuarialLedger": { "type": "boolean", "description": "Include statutory ledger table" }
        },
        "required": ["taxYear"]
      }
    },
    {
      "name": "navigate_platform_section",
      "description": "Steers browser navigation to any route or triggers modal dialogs (booking consultation, command palette, authentication).",
      "parameters": {
        "type": "object",
        "properties": {
          "targetRoute": { "type": "string", "enum": ["/", "/simulator", "/fiduciary", "/fortress", "/solutions", "/portal"], "description": "Target page route" },
          "modalId": { "type": "string", "enum": ["booking", "command_palette", "auth"], "description": "Specific overlay modal to open" },
          "scrollToId": { "type": "string", "description": "HTML ID element to smoothly scroll to" }
        }
      }
    },
    {
      "name": "generate_executive_wealth_brief",
      "description": "Synthesizes Point A baseline vitals and Point B strategy accumulation into a board-level executive wealth memorandum.",
      "parameters": {
        "type": "object",
        "properties": {
          "clientName": { "type": "string", "description": "Name of the client or family office" },
          "primaryGoal": { "type": "string", "description": "Strategic wealth goal" }
        },
        "required": ["clientName"]
      }
    },
    {
      "name": "schedule_advisor_consultation",
      "description": "Triggers a private wealth advisory consultation request for senior wealth architecture review.",
      "parameters": {
        "type": "object",
        "properties": {
          "fullName": { "type": "string", "description": "Full name of client" },
          "email": { "type": "string", "description": "Email address" },
          "phone": { "type": "string", "description": "Phone number" },
          "primaryObjective": { "type": "string", "description": "Tax optimization, estate preservation, or IUL design" }
        },
        "required": ["fullName", "email"]
      }
    }
  ]
}
