{
  "openapi": "3.1.0",
  "info": {
    "title": "Pinnacle Wealth Advisory WebMCP API",
    "description": "Institutional private wealth advisory tools for estate tax evaluation, 401(k) tax drag, IRC §162 executive bonus, buy-sell agreements, carrier solvency audits, and zero-knowledge client vault queries.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://pinnacle.wagents.app"
    }
  ],
  "paths": {
    "/tools/calculate_estate_tax_exposure": {
      "post": {
        "operationId": "calculateEstateTaxExposure",
        "summary": "Calculate 2026 TCJA sunset estate tax liability and ILIT requirements",
        "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.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "grossEstateValue": { "type": "number", "description": "Gross estate valuation in USD" },
                  "isMarried": { "type": "boolean", "description": "Whether client is married" },
                  "hasExistingILIT": { "type": "boolean", "description": "Whether client has an ILIT" }
                },
                "required": ["grossEstateValue"]
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Estate tax liability and ILIT requirements" }
        }
      }
    },
    "/tools/compare_401k_vs_iul_tax_drag": {
      "post": {
        "operationId": "compare401kVsIulTaxDrag",
        "summary": "Compare 401k RMD tax penalties vs IRC 7702 tax-free policy loans",
        "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.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "annualContribution": { "type": "number" },
                  "yearsToRetire": { "type": "number" },
                  "retirementAnnualDistribution": { "type": "number" },
                  "projectedTaxBracket": { "type": "number" }
                },
                "required": ["annualContribution", "yearsToRetire"]
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Tax drag analysis" }
        }
      }
    },
    "/tools/model_executive_bonus_split_dollar": {
      "post": {
        "operationId": "modelExecutiveBonusSplitDollar",
        "summary": "Model IRC 162 executive bonus retention with corporate deductions",
        "description": "Models an IRC §162(a)(1) executive retention bonus ('Golden Handcuffs') with corporate tax deductions and Restrictive Endorsement Agreements (REA).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "annualBonusAmount": { "type": "number" },
                  "retentionYears": { "type": "number" },
                  "corporateTaxRate": { "type": "number" }
                },
                "required": ["annualBonusAmount"]
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Executive bonus model" }
        }
      }
    },
    "/tools/audit_buy_sell_agreement": {
      "post": {
        "operationId": "auditBuySellAgreement",
        "summary": "Audit cross-purchase vs entity redemption business succession funding",
        "description": "Audits cross-purchase vs entity redemption buy-sell agreements, evaluating partner count, step-up in basis under IRC §1014, and liquidity shortfall.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "businessValuation": { "type": "number" },
                  "numberOfOwners": { "type": "number" },
                  "existingInsuranceFunding": { "type": "number" },
                  "agreementType": { "type": "string" }
                },
                "required": ["businessValuation"]
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Buy-sell audit" }
        }
      }
    },
    "/tools/audit_carrier_solvency": {
      "post": {
        "operationId": "auditCarrierSolvency",
        "summary": "Audit Tier-1 institutional carrier financial strength",
        "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.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "carrierName": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Carrier solvency audit" }
        }
      }
    },
    "/tools/query_vault_documents": {
      "post": {
        "operationId": "queryVaultDocuments",
        "summary": "Query encrypted documents in the Stewardship Vault",
        "description": "Queries simulated AES-256 GCM client stewardship vault records (Trust Agreements, K-1s, 7702 Actuarial Ledgers) with SHA-256 integrity hashes.",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "searchCategory": { "type": "string" },
                  "includeMetadata": { "type": "boolean" }
                }
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Vault query results" }
        }
      }
    },
    "/tools/generate_cpa_annual_audit_pack": {
      "post": {
        "operationId": "generateCpaAnnualAuditPack",
        "summary": "Generate annual CPA 7702 compliance and tax reconciliation pack",
        "description": "Synthesizes an annual CPA tax compliance and 7702 reconciliation workpaper (Non-MEC 7-Pay verification, Form 1099-R exempt status).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "taxYear": { "type": "number" },
                  "includeActuarialLedger": { "type": "boolean" }
                },
                "required": ["taxYear"]
              }
            }
          }
        },
        "responses": {
          "200": { "description": "CPA audit pack" }
        }
      }
    },
    "/tools/generate_executive_wealth_brief": {
      "post": {
        "operationId": "generateExecutiveWealthBrief",
        "summary": "Generate a board-level executive wealth strategy memorandum",
        "description": "Synthesizes Point A baseline vitals and Point B strategy accumulation into a board-level executive wealth memorandum.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clientName": { "type": "string" },
                  "primaryGoal": { "type": "string" }
                },
                "required": ["clientName"]
              }
            }
          }
        },
        "responses": {
          "200": { "description": "Executive brief" }
        }
      }
    }
  }
}
