US Tax Estimator
by yz-cpa.com · remote · no sign-in to list tools · v1.1.0 · published by com.yz-cpa
Federal tax estimate, deadlines, FBAR/8938/3520 checks, §7702 screen, inherited-stock step-up.
6 tools: 4 change things and 2 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things4Claude Code: ask: see these tools
- Only reads2Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http us-tax-estimator https://my.yz-cpa.com/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
6 tools
Changes things 4Claude Code: ask
check_foreign_reporting_requirementsChecks a U.S.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- readOnlyHint: true
- title: Check FBAR, Form 8938 and Form 3520 thresholds
estimate_federal_taxEstimates a year's U.S.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- readOnlyHint: true
- title: Estimate federal income and self-employment tax
estimate_inheritance_step_upFor 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 …No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
- readOnlyHint: true
- title: Estimate the basis step-up on inherited stocks and funds
screen_foreign_life_insurance_7702Preliminary screen of whether a non-U.S.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- readOnlyHint: true
- title: Screen a non-U.S. life insurance policy under IRC §7702
Only reads 2Claude Code: allow
compare_offshore_compliance_optionsFor a U.S.No findings
Why it is in this group
- The name "compare_offshore_compliance_options" says "compare": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- readOnlyHint: true
- title: Compare catch-up options for unreported foreign assets
list_federal_tax_deadlinesLists upcoming U.S.No findings
Why it is in this group
- The name "list_federal_tax_deadlines" says "list": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
- readOnlyHint: true
- title: Upcoming federal tax deadlines
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.1.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http us-tax-estimator https://my.yz-cpa.com/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__us-tax-estimator__list_federal_tax_deadlines",
"mcp__us-tax-estimator__compare_offshore_compliance_options"
],
"ask": [
"mcp__us-tax-estimator__estimate_federal_tax",
"mcp__us-tax-estimator__check_foreign_reporting_requirements",
"mcp__us-tax-estimator__screen_foreign_life_insurance_7702",
"mcp__us-tax-estimator__estimate_inheritance_step_up"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as us-tax-estimator. Review it before you use it.