US Tax Estimator

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Federal tax estimate, deadlines, FBAR/8938/3520 checks, §7702 screen, inherited-stock step-up.

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "US Tax Estimator": {
      "url": "https://my.yz-cpa.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• estimate_federal_tax read-only

  Estimates a year's U.S. federal income tax plus self-employment tax, the refund or balance due after withholding and estimated payments, marginal and effective rates, a bracket-by-bracket breakdown and, when prior-year figures are given, the safe-harbor quarterly estimated payment. Also answers 'how much more can I earn, withdraw from a 401(k) or convert to a Roth IRA before the next bracket': the room left in the current bracket, the room before qualified dividends / long-term gains lose the 0% rate, and the tax on a planned extra amount. Uses the standard deduction (with the age-65+ addition) unless larger itemized deductions are given; the 2025–2028 $6,000 senior deduction with phase-out; qualified dividends and long-term gains at 0%/15%/20%; child tax credit with phase-out; Social Security wage base and Additional Medicare tax. Federal only: no state tax, AMT, NIIT, QBI deduction, IRMAA or other credits.

  Parameters:

  • filing_status (required) — string — Federal filing status.
  • tax_year (required) — integer — Tax year: 2025 or 2026.
  • total_income (required) — number — Total income for the year before deductions, USD: wages, interest, dividends, other income and self-employment profit together.
  • w2_wages — number — W-2 wages (Social Security / Medicare wages), USD; reduces the self-employment Social Security tax room. 0 if none.
  • prior_year_agi — number — Last year's adjusted gross income, USD (decides 100% vs 110% safe harbor).
  • federal_withholding — number — Federal income tax withheld for the year (W-2 box 2, 1099 withholding), USD.
  • itemized_deductions — number — Total itemized deductions (Schedule A), USD. Used only when larger than the standard deduction.
  • qualifying_children — integer — Children under 17 who qualify for the child tax credit.
  • planned_extra_income — number — What-if: extra ordinary income being considered for the year (401(k) or IRA withdrawal, Roth conversion, bonus), USD, NOT included in total_income. Returns the tax it adds and the marginal rate after.
  • prior_year_total_tax — number — Last year's total federal tax, USD. Give it to get the quarterly safe-harbor payment.
  • self_employment_profit — number — Net self-employment profit (Schedule C), USD. Already included in total_income; used for self-employment tax.
  • estimated_payments_made — number — Federal estimated tax payments already made for this year, USD.
  • taxpayers_age_65_or_older — integer — Taxpayers on the return who are 65 or older by year end (0, 1 or 2): adds the age-65+ standard deduction and the $6,000 senior deduction (2025–2028).
  • qualified_dividends_and_long_term_gains — number — Qualified dividends (1099-DIV box 1b) plus net long-term capital gains, USD. Part of total_income; taxed at 0%/15%/20% stacked on top of ordinary income.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_federal_tax_deadlines read-only

  Lists upcoming U.S. federal tax deadlines with days remaining: quarterly estimated payments (1040-ES), individual return and extension dates, and optionally S-corporation, partnership and C-corporation return and estimated-tax dates. Dates are already moved off weekends and holidays.

  Parameters:

  • limit — integer — Maximum number of deadlines to return.
  • from_date — string — List deadlines on or after this date (YYYY-MM-DD). Default: today (U.S. Central).
  • include_business — boolean — Also list business return and C-corporation estimated tax dates.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• check_foreign_reporting_requirements read-only

  Checks a U.S. person's foreign-asset figures against the filing thresholds for FBAR (FinCEN Form 114), Form 8938 (FATCA) and Form 3520 (gifts or bequests from a foreign individual or estate). Only the forms whose figures are given are checked. Thresholds only: it does not decide which accounts or assets count; the descriptions of each input say what to include.

  Parameters:

  • filing_status (required) — string — Federal filing status.
  • lives_abroad — boolean — Form 8938: true if the taxpayer meets the bona fide residence or physical presence test abroad (higher thresholds).
  • foreign_gifts_received — number — Form 3520: total gifts and bequests received in the year from nonresident alien individuals or foreign estates, USD.
  • specified_foreign_assets_max — number — Form 8938: the highest value of specified foreign financial assets at any time in the year, USD.
  • foreign_accounts_max_aggregate — number — FBAR: the highest combined value of all foreign financial accounts at any time in the year, USD.
  • specified_foreign_assets_year_end — number — Form 8938: value of specified foreign financial assets on the last day of the year, USD.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• screen_foreign_life_insurance_7702 read-only

  Preliminary screen of whether a non-U.S. savings-type life insurance policy (for example a Hong Kong whole-life or savings plan) meets the U.S. definition of life insurance under IRC §7702, using the cash value accumulation test (CVAT) and the cash value corridor, from the policy's cash value table. A policy that fails is taxed each year on its inside growth (§7702(g)). Values in any one currency (ratios do not depend on currency). Does not check the guideline premium limit.

  Parameters:

  • issue_age (required) — integer — Insured's age at issue, completed years.
  • issue_year (required) — integer — Calendar year the policy was issued.
  • policy_years (required) — array — Rows from the policy's illustration / cash value table; a few years such as 1, 5, 10, 20 are enough.
  • sex (required) — string — Insured's sex (mortality table).
  • increasing_benefit_rule — object — For policies whose death benefit grows by a fixed rate: lets years without a death_benefit be computed.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compare_offshore_compliance_options read-only

  For a U.S. taxpayer who missed FBAR or Form 8938 filings or left foreign income unreported, estimates and compares the cost of three catch-up paths: A) delinquent information return procedures (only when no income went unreported), B) amended returns with tax and interest plus a reasonable-cause statement (with the statutory penalty exposure if reasonable cause is rejected), and C) the Streamlined Domestic Offshore Procedures (tax, interest and the 5% penalty). Also adds the 1% Form 720 excise tax on premiums paid to foreign insurers. Tax years 2019–2025. Assumes non-willful conduct; it does not decide eligibility.

  Parameters:

  • filing_status (required) — string — Filing status used on the original returns.
  • years (required) — array — One entry per affected tax year.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• estimate_inheritance_step_up read-only

  For U.S.-listed stocks, ETFs, mutual funds or crypto held at someone's death (directly, in an estate or in a revocable living trust), estimates the value on the date of death from public market prices, the IRC §1014 step-up in cost basis and the capital-gains tax the heirs avoid (15%–23.8%), plus the dates that matter: the §2032 alternate valuation date, the Form 706 due date and the last day for a portability election (Rev. Proc. 2022-32). Valuation follows Treas. Reg. §20.2031-2(b) (mean of high and low, weekend and no-trade days weighted) and §20.2031-8(b) for funds. Up to 25 holdings. An estimate for planning, not a signed valuation a broker or the IRS will accept; the reply says where to get one.

  Parameters:

  • date_of_death (required) — string — Date of death, YYYY-MM-DD (must be before today).
  • holdings (required) — array — Holdings at the date of death.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.