io.github.dma9527/irs-taxpayer
NPM · IRS-TAXPAYER-MCP · SCANNED AUG 3
39 tax tools for US taxpayers: federal/state tax, credits, deductions, retirement. All local.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 159 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability74
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 5869 tokens (~139/item across 42 items; 42 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage93
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 80% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · irs-taxpayer-mcp
claude mcp add dma9527-irs-taxpayer -- npx -y irs-taxpayer-mcp
codex mcp add dma9527-irs-taxpayer -- npx -y irs-taxpayer-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"dma9527-irs-taxpayer": {
"type": "local",
"command": [
"npx",
"-y",
"irs-taxpayer-mcp"
],
"enabled": true
}
}
} openclaw mcp add dma9527-irs-taxpayer --command npx --arg -y --arg irs-taxpayer-mcp
mcp_servers:
dma9527-irs-taxpayer:
command: "npx"
args: ["-y", "irs-taxpayer-mcp"] {
"mcpServers": {
"dma9527-irs-taxpayer": {
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
- 2 Aug 26 +45
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Schema quality: unverified functional
- Licence: MIT functional
- 31 Jul 26 −6
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 27 Jul 26 43
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 95 packages
95 packages in the resolved dependency tree · 95 deprecated · 29 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
analyze_education_tax_benefits ~159
Compare education tax benefits: AOTC vs Lifetime Learning Credit, student loan interest deduction, and 529 plan advantages.
| Name | Type | Req | Description |
|---|---|---|---|
| agi | number | yes | Adjusted Gross Income |
| contribution529 | number | — | 529 plan contribution this year |
| filingStatus | string | yes | — |
| has529Plan | boolean | — | Contributing to or using a 529 plan |
| isUndergrad | boolean | yes | Is the student in first 4 years of undergrad? |
| studentLoanInterest | number | — | Student loan interest paid this year |
| tuitionPaid | number | yes | Tuition and qualified expenses paid |
| yearsAOTCClaimed | integer | — | Years AOTC already claimed (max 4) |
No output schema declared.
No examples provided.
analyze_mortgage_tax_benefit ~157
Analyze the tax benefit of mortgage interest deduction and property taxes. Compares itemizing with mortgage vs taking the standard deduction.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | yes | — |
| grossIncome | number | yes | — |
| interestRate | number | — | Mortgage interest rate (e.g., 0.065 for 6.5%) |
| mortgageBalance | number | — | Current mortgage balance |
| mortgageInterest | number | yes | Annual mortgage interest paid |
| otherItemized | number | — | Other itemized deductions (charity, medical, etc.) |
| propertyTaxes | number | yes | Annual property taxes paid |
| stateIncomeTaxes | number | — | State/local income taxes paid |
| taxYear | number | yes | Tax year |
No output schema declared.
No examples provided.
analyze_paycheck ~166
Analyze a paycheck to verify withholding accuracy. Input your pay stub numbers and see if your employer is withholding the right amount.
| Name | Type | Req | Description |
|---|---|---|---|
| federalWithheld | number | yes | Federal tax withheld this period |
| filingStatus | string | yes | — |
| grossPay | number | yes | Gross pay this period |
| hsaContribution | number | — | HSA contribution this period |
| medicareWithheld | number | — | Medicare withheld |
| payFrequency | string | yes | — |
| retirement401k | number | — | 401k/403b pre-tax contribution this period |
| socialSecurityWithheld | number | — | Social Security withheld |
| stateCode | string | — | — |
| stateWithheld | number | — | State tax withheld this period |
| taxYear | number | yes | Tax year |
No output schema declared.
No examples provided.
analyze_relocation_taxes ~157
In-depth relocation tax analysis comparing two states. Includes state income tax, effective combined rate, local taxes, and multi-year savings projection.
| Name | Type | Req | Description |
|---|---|---|---|
| capitalGains | number | — | — |
| dependents | integer | — | — |
| filingStatus | string | yes | — |
| fromState | string | yes | Current state code |
| grossIncome | number | yes | Annual gross income |
| incomeGrowthRate | number | — | Annual income growth rate (e.g., 0.03 for 3%) |
| selfEmploymentIncome | number | — | — |
| taxYear | number | yes | Tax year |
| toState | string | yes | Target state code |
| yearsToProject | integer | — | Years to project savings (default: 5) |
No output schema declared.
No examples provided.
assess_audit_risk ~252
Evaluate your IRS audit risk based on your tax return profile. Identifies red flags, scores your risk level, and provides tips to reduce audit exposure.
| Name | Type | Req | Description |
|---|---|---|---|
| businessMeals | number | — | Business meal deductions |
| cashBusiness | boolean | — | Is your business cash-intensive (restaurant, salon, etc.)? |
| charitableDonations | number | — | Total charitable donations |
| charitableNonCash | number | — | Non-cash charitable donations (clothing, property) |
| cryptoTransactions | boolean | — | Had cryptocurrency transactions? |
| eitcClaimed | boolean | — | Claiming EITC? |
| filingStatus | string | yes | — |
| foreignAccounts | boolean | — | Have foreign bank accounts or assets? |
| grossIncome | number | yes | Total gross income |
| homeOfficeDeduction | boolean | — | Claiming home office deduction? |
| largeRefund | boolean | — | Expecting a very large refund? |
| rentalLosses | number | — | Rental property losses claimed |
| roundNumbers | boolean | — | Are most deductions round numbers ($5,000, $10,000)? |
| selfEmploymentIncome | number | — | Self-employment income |
| vehicleDeduction | number | — | Vehicle/mileage deduction |
No output schema declared.
No examples provided.
calculate_eitc ~135
Calculate the exact Earned Income Tax Credit (EITC) amount. The EITC is one of the largest refundable credits for low-to-moderate income workers.
| Name | Type | Req | Description |
|---|---|---|---|
| agi | number | yes | Adjusted Gross Income |
| earnedIncome | number | yes | Earned income (wages, salary, self-employment) |
| filingStatus | string | yes | — |
| investmentIncome | number | — | Investment income (interest, dividends, capital gains) |
| qualifyingChildren | integer | yes | Number of qualifying children (0-3) |
| taxYear | number | yes | Tax year (2024 or 2025) |
No output schema declared.
No examples provided.
calculate_federal_tax ~356
Calculate federal income tax for an individual taxpayer. Supports TY2024 and TY2025. Includes bracket breakdown, effective/marginal rates, SE tax, NIIT, Additional Medicare Tax, QBI deduction, capital gains, and child tax credit. All calculations run locally — no data is sent to any server.
| Name | Type | Req | Description |
|---|---|---|---|
| aboveTheLineDeductions | number | — | Above-the-line deductions (HSA, student loan interest, etc.) |
| age65OrOlder | boolean | — | Taxpayer is 65 or older |
| blind | boolean | — | Taxpayer is blind |
| capitalGains | number | — | Long-term capital gains (can be negative for losses) |
| capitalGainsLongTerm | boolean | — | Whether capital gains are long-term (default: true) |
| dependents | integer | — | Number of qualifying child dependents for Child Tax Credit |
| filingStatus | string | yes | Filing status |
| grossIncome | number | yes | Total gross income in USD |
| isoExerciseSpread | number | — | ISO stock option exercise spread (for AMT calculation) |
| itemizedDeductions | number | — | Total itemized deductions (if greater than standard deduction) |
| qualifiedBusinessIncome | number | — | Qualified Business Income for Section 199A deduction |
| selfEmploymentIncome | number | — | Self-employment income (Schedule C) |
| shortTermCapitalGains | number | — | Short-term capital gains (taxed as ordinary income) |
| stateTaxDeducted | number | — | State/local taxes included in itemized deductions (for AMT) |
| taxYear | number | yes | Tax year (2024 or 2025) |
| w2Income | number | — | W-2 wage income |
No output schema declared.
No examples provided.
calculate_obbb_deductions ~191
Calculate all OBBB (One Big Beautiful Bill) new deductions for TY2025+: tips income deduction, overtime pay deduction, senior bonus deduction, and auto loan interest deduction. Shows which deductions you qualify for and the total tax savings.
| Name | Type | Req | Description |
|---|---|---|---|
| age | integer | — | Taxpayer age (needed for senior bonus) |
| agi | number | yes | Adjusted Gross Income |
| autoLoanInterest | number | — | Interest paid on qualifying US-assembled new vehicle loan |
| filingStatus | string | yes | — |
| marginalRate | number | — | Your marginal tax rate (for savings estimate, e.g. 0.22) |
| overtimePay | number | — | Annual overtime premium pay |
| spouseAge | integer | — | Spouse age if MFJ |
| taxYear | number | yes | Tax year (2025+) |
| tipIncome | number | — | Annual tip income from qualifying occupation |
No output schema declared.
No examples provided.
calculate_total_tax ~225
Calculate combined federal + state tax for a complete picture of total tax liability. Returns federal breakdown, state tax, and combined totals in one call.
| Name | Type | Req | Description |
|---|---|---|---|
| aboveTheLineDeductions | number | — | Above-the-line deductions |
| capitalGains | number | — | Long-term capital gains |
| capitalGainsLongTerm | boolean | — | Whether capital gains are long-term (default: true) |
| dependents | integer | — | Number of qualifying child dependents |
| filingStatus | string | yes | Filing status |
| grossIncome | number | yes | Total gross income in USD |
| itemizedDeductions | number | — | Total itemized deductions |
| qualifiedBusinessIncome | number | — | QBI for Section 199A deduction |
| selfEmploymentIncome | number | — | Self-employment income |
| stateCode | string | yes | Two-letter state code (e.g., 'CA', 'TX', 'NY') |
| taxYear | number | yes | Tax year (2024 or 2025) |
| w2Income | number | — | W-2 wage income |
No output schema declared.
No examples provided.
calculate_w4_withholding ~164
Calculate recommended W-4 withholding settings. Estimates per-paycheck federal tax and provides step-by-step W-4 form recommendations.
| Name | Type | Req | Description |
|---|---|---|---|
| annualSalary | number | yes | Annual salary from this job |
| deductions | number | — | Expected itemized deductions (if more than standard) |
| dependents | integer | — | Number of qualifying child dependents |
| filingStatus | string | yes | Filing status |
| multipleJobs | boolean | — | Do you hold multiple jobs simultaneously? |
| otherIncome | number | — | Other annual income (interest, dividends, side gigs) |
| payFrequency | string | yes | How often you get paid |
| spouseWorks | boolean | — | Does your spouse also work? |
| taxYear | number | yes | Tax year (2024 or 2025) |
No output schema declared.
No examples provided.
check_credit_eligibility ~215
Check which tax credits you may be eligible for based on your situation.
| Name | Type | Req | Description |
|---|---|---|---|
| agi | number | yes | Adjusted Gross Income |
| boughtEV | boolean | — | Purchased an electric vehicle this year |
| filingStatus | string | yes | — |
| hasChildcare | boolean | — | Pay for childcare to work |
| hasChildren | boolean | — | Have qualifying children under 17 |
| hasEarnedIncome | boolean | — | Has earned income from work |
| hasMarketplaceInsurance | boolean | — | Bought health insurance through ACA marketplace |
| hasRetirementContributions | boolean | — | Contributed to IRA/401k |
| hasStudentLoans | boolean | — | Paying student loan interest |
| installedSolar | boolean | — | Installed solar panels or renewable energy |
| isStudent | boolean | — | Currently enrolled in post-secondary education |
| madeHomeImprovements | boolean | — | Made energy-efficient home improvements |
| numChildren | integer | — | — |
| paidForeignTax | boolean | — | Paid income tax to a foreign country |
No output schema declared.
No examples provided.
check_refund_status ~53
Provide instructions on how to check IRS refund status. This tool does NOT access your IRS account — it provides the official links and requirements.
| Name | Type | Req | Description |
|---|---|---|---|
| filedElectronically | boolean | — | Whether the return was e-filed |
No output schema declared.
No examples provided.
compare_filing_statuses ~88
Compare tax liability across different filing statuses for the same income. Helps determine the most advantageous filing status.
| Name | Type | Req | Description |
|---|---|---|---|
| dependents | integer | — | Number of qualifying dependents |
| grossIncome | number | yes | Total gross income |
| itemizedDeductions | number | — | Itemized deductions if applicable |
| taxYear | number | yes | Tax year (2024 or 2025) |
No output schema declared.
No examples provided.
compare_mfj_vs_mfs ~194
Compare Married Filing Jointly (MFJ) vs Married Filing Separately (MFS). Shows tax difference and lists all MFS restrictions that may affect your situation.
| Name | Type | Req | Description |
|---|---|---|---|
| dependents | integer | — | Number of qualifying children |
| hasEITC | boolean | — | Either spouse would qualify for EITC |
| hasEducationCredits | boolean | — | Either spouse claiming AOTC or LLC |
| hasIRAContributions | boolean | — | Either spouse contributing to IRA |
| itemizedDeductions | number | — | Total itemized deductions (combined for MFJ, split for MFS) |
| spouse1Income | number | yes | Spouse 1 gross income |
| spouse2Income | number | yes | Spouse 2 gross income |
| studentLoanInterest | boolean | — | Either spouse paying student loan interest |
| taxYear | number | yes | Tax year (2024 or 2025) |
No output schema declared.
No examples provided.
compare_state_taxes ~66
Compare state income tax across multiple states for the same income. Useful for relocation decisions.
| Name | Type | Req | Description |
|---|---|---|---|
| states | array | yes | Array of state codes to compare (e.g., ['CA', 'TX', 'WA', 'NY']) |
| taxableIncome | number | yes | Annual taxable income |
No output schema declared.
No examples provided.
compare_tax_years ~72
Compare tax liability across different tax years for the same income. Shows how bracket changes and inflation adjustments affect your tax.
| Name | Type | Req | Description |
|---|---|---|---|
| dependents | integer | — | — |
| filingStatus | string | yes | — |
| grossIncome | number | yes | Gross income to compare across years |
| selfEmploymentIncome | number | — | — |
No output schema declared.
No examples provided.
estimate_quarterly_tax ~114
Calculate estimated quarterly tax payments (Form 1040-ES) for self-employed or other taxpayers who need to make estimated payments.
| Name | Type | Req | Description |
|---|---|---|---|
| expectedAnnualIncome | number | yes | Expected total annual income |
| filingStatus | string | yes | — |
| otherCredits | number | — | Expected other tax credits |
| selfEmploymentIncome | number | — | Expected self-employment income |
| taxYear | number | yes | Tax year |
| w2Withholding | number | — | Expected total W-2 tax withholding for the year |
No output schema declared.
No examples provided.
estimate_self_employment_tax ~140
Detailed self-employment tax breakdown including Schedule C profit, SE tax, QBI deduction, and recommended quarterly payments.
| Name | Type | Req | Description |
|---|---|---|---|
| businessExpenses | number | yes | Total business expenses (Schedule C) |
| dependents | integer | — | — |
| filingStatus | string | yes | — |
| grossRevenue | number | yes | Total business revenue (Schedule C line 1) |
| healthInsurancePremiums | number | — | Self-employed health insurance premiums |
| otherW2Income | number | — | W-2 income from other jobs |
| retirementContributions | number | — | SEP IRA or Solo 401k contributions |
| taxYear | number | yes | Tax year |
No output schema declared.
No examples provided.
estimate_state_tax ~68
Estimate state income tax for a given income and state. Simplified calculation using state brackets.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | — | Filing status (default: single) |
| stateCode | string | yes | Two-letter state code |
| taxableIncome | number | yes | State taxable income (after state deductions) |
No output schema declared.
No examples provided.
generate_full_tax_report ~373
Generate a full tax estimate report combining federal tax, state tax, FICA, all credits and deductions into one summary. Like a TurboTax final page.
| Name | Type | Req | Description |
|---|---|---|---|
| aboveTheLineDeductions | number | — | HSA, student loan interest, educator expenses, etc. |
| charitableDonations | number | — | Charitable contributions |
| dependents | integer | — | Qualifying children under 17 |
| dividendIncome | number | — | 1099-DIV ordinary dividends |
| estimatedPaymentsMade | number | — | Estimated tax payments already made |
| federalWithheld | number | — | Federal tax already withheld YTD |
| filingStatus | string | yes | — |
| interestIncome | number | — | 1099-INT interest income |
| longTermCapitalGains | number | — | Long-term capital gains/losses |
| medicalExpenses | number | — | Unreimbursed medical expenses |
| mortgageInterest | number | — | Mortgage interest |
| otherIncome | number | — | Other income (rental, alimony, etc.) |
| otherItemized | number | — | Other itemized deductions |
| qualifiedBusinessIncome | number | — | QBI for Section 199A |
| qualifiedDividends | number | — | Qualified dividends (subset of dividends, taxed at CG rates) |
| selfEmploymentIncome | number | — | Self-employment net profit |
| shortTermCapitalGains | number | — | Short-term capital gains/losses |
| stateCode | string | — | State code for state tax estimate |
| stateLocalTaxesPaid | number | — | State/local/property taxes paid |
| stateWithheld | number | — | State tax already withheld YTD |
| taxYear | number | yes | Tax year (2024 or 2025) |
| w2Income | number | — | W-2 wages |
No output schema declared.
No examples provided.
get_form_filing_guide ~78
Step-by-step guide for filling out a specific IRS form or schedule. Explains each section, what data you need, and common mistakes to avoid.
| Name | Type | Req | Description |
|---|---|---|---|
| formNumber | string | yes | IRS form (e.g., '1040', 'Schedule C', 'Schedule D', 'Form 8949', 'W-4') |
No output schema declared.
No examples provided.
get_irs_form_info ~67
Get information about common IRS tax forms — what they are, who needs them, and where to find them.
| Name | Type | Req | Description |
|---|---|---|---|
| formNumber | string | yes | IRS form number (e.g., '1040', 'W-2', '1099-NEC', 'Schedule C') |
No output schema declared.
No examples provided.
get_personalized_tax_calendar ~124
Generate a personalized tax calendar based on your situation. Shows deadlines for filing, estimated payments, extensions, and key actions.
| Name | Type | Req | Description |
|---|---|---|---|
| filedExtension | boolean | — | Did you file an extension? |
| hasEmployer | boolean | — | Do you have W-2 employment? |
| hasInvestments | boolean | — | Do you have investment accounts? |
| hasRentalIncome | boolean | — | Do you have rental property income? |
| isSelfEmployed | boolean | — | Do you have self-employment income? |
| taxYear | number | yes | Tax year to get calendar for |
No output schema declared.
No examples provided.
get_retirement_accounts ~66
Get details on retirement account types — contribution limits, tax treatment, income limits, and tips.
| Name | Type | Req | Description |
|---|---|---|---|
| accountType | string | — | Specific account (e.g., 'roth_ira', '401k', 'hsa', 'sep_ira'). Leave empty for all |
No output schema declared.
No examples provided.
get_retirement_strategy ~93
Get detailed info on tax-advantaged retirement strategies like Backdoor Roth, Mega Backdoor Roth, Roth Conversion Ladder, Tax Loss/Gain Harvesting.
| Name | Type | Req | Description |
|---|---|---|---|
| strategyId | string | — | Strategy ID (e.g., 'backdoor_roth', 'mega_backdoor_roth', 'roth_conversion_ladder', 'tax_loss_harvesting', 'tax_gain_harvesting'). Leave empty for all |
No output schema declared.
No examples provided.
get_state_tax_info ~52
Get state income tax information — rates, brackets, and key details for any US state.
| Name | Type | Req | Description |
|---|---|---|---|
| stateCode | string | yes | Two-letter state code (e.g., 'CA', 'TX', 'NY') |
No output schema declared.
No examples provided.
get_tax_brackets ~54
Get federal income tax brackets and standard deduction for a given tax year and filing status.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | yes | Filing status |
| taxYear | number | yes | Tax year (2024 or 2025) |
No output schema declared.
No examples provided.
get_tax_deadlines ~40
Get important IRS tax deadlines and due dates for a given tax year.
| Name | Type | Req | Description |
|---|---|---|---|
| taxYear | number | — | Tax year (default: 2025) |
No output schema declared.
No examples provided.
get_tax_document_checklist ~312
Generate a personalized checklist of tax documents you need to gather for filing. Based on your income sources, deductions, and life events.
| Name | Type | Req | Description |
|---|---|---|---|
| boughtEV | boolean | — | Bought an electric vehicle |
| gotDivorced | boolean | — | Got divorced this year |
| gotMarried | boolean | — | Got married this year |
| hadBaby | boolean | — | Had a baby this year |
| hasCharitableDonations | boolean | — | Made charitable donations |
| hasChildcare | boolean | — | Pay for childcare |
| hasChildren | boolean | — | Have dependent children |
| hasEducationExpenses | boolean | — | Paying tuition or student expenses |
| hasForeignAccounts | boolean | — | Have foreign bank accounts or income |
| hasHSA | boolean | — | Have HSA account |
| hasHealthInsurance | boolean | — | Have health insurance (marketplace or employer) |
| hasInvestments | boolean | — | Have investment accounts (stocks, bonds, crypto) |
| hasMortgage | boolean | — | Have a mortgage |
| hasRentalProperty | boolean | — | Own rental property |
| hasRetirementContributions | boolean | — | Contributed to IRA/401k |
| hasSelfEmployment | boolean | — | Have self-employment/freelance income |
| hasStudentLoans | boolean | — | Paying student loans |
| hasW2 | boolean | — | Have W-2 employment |
| installedSolar | boolean | — | Installed solar panels |
| soldHome | boolean | — | Sold a home this year |
No output schema declared.
No examples provided.
get_tax_planning_tips ~230
Get personalized year-end tax optimization strategies based on your income, deductions, and situation. Suggests actions to reduce tax liability before year-end.
| Name | Type | Req | Description |
|---|---|---|---|
| charitableGiving | number | — | YTD charitable donations |
| currentHSAContributions | number | — | YTD HSA contributions |
| currentRetirementContributions | number | — | YTD retirement contributions |
| currentWithholding | number | — | Total tax already withheld/paid YTD |
| estimatedCapitalGains | number | — | — |
| estimatedIncome | number | yes | Expected total income for the year |
| estimatedItemizedDeductions | number | — | — |
| filingStatus | string | yes | — |
| hasCapitalGains | boolean | — | — |
| hasCapitalLosses | boolean | — | — |
| hasHSA | boolean | — | Have HSA-eligible health plan |
| hasMortgage | boolean | — | — |
| hasRetirementPlan | boolean | — | Have access to 401k/403b |
| isSelfEmployed | boolean | — | — |
| taxYear | number | yes | Tax year to plan for |
No output schema declared.
No examples provided.
list_deductions ~45
List available tax deductions with eligibility rules and limits. Covers both above-the-line and itemized deductions.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Filter by deduction category (default: all) |
No output schema declared.
No examples provided.
list_no_income_tax_states ~21
List all US states with no state income tax.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_tax_credits ~67
List available federal tax credits with eligibility, amounts, and phase-out rules. Covers family, education, energy, retirement, healthcare, and income-based credits.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Filter by category (default: all) |
| refundableOnly | boolean | — | Only show refundable credits |
No output schema declared.
No examples provided.
lookup_tax_rule ~87
Look up IRS tax rules, definitions, and common questions. Covers filing rules, income types, deduction rules, credit eligibility, stock options, wash sales, and more.
| Name | Type | Req | Description |
|---|---|---|---|
| topic | string | yes | Tax topic to look up (e.g., 'wash sale rule', 'ISO vs NSO', 'AOTC and LLC same year', 'gift tax', 'estimated tax penalty') |
No output schema declared.
No examples provided.
optimize_capital_gains ~120
Analyze investment lots and suggest which to sell to minimize tax. Considers long-term vs short-term, 0% bracket space, loss harvesting, and wash sale rules.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | yes | — |
| lots | array | yes | Investment lots to analyze |
| ordinaryIncome | number | yes | Ordinary income (W-2, SE, interest, etc.) before investment sales |
| targetGainOrLoss | number | — | Target net gain/loss to realize (negative for harvesting losses) |
| taxYear | number | yes | Tax year |
No output schema declared.
No examples provided.
plan_multi_year_taxes ~67
Create a 3-5 year tax projection and strategy. Models income changes, Roth conversions, retirement contributions, and bracket management across multiple years.
| Name | Type | Req | Description |
|---|---|---|---|
| currentAge | integer | yes | — |
| filingStatus | string | yes | — |
| years | array | yes | Year-by-year projections |
No output schema declared.
No examples provided.
plan_retirement_withdrawals ~160
Plan tax-efficient retirement withdrawals. Determines optimal order to draw from Traditional IRA, Roth IRA, and taxable accounts to minimize lifetime tax.
| Name | Type | Req | Description |
|---|---|---|---|
| age | integer | yes | Your current age |
| annualSpending | number | yes | Annual spending need (pre-tax) |
| filingStatus | string | yes | — |
| pensionIncome | number | — | Annual pension income |
| rothBalance | number | yes | Roth IRA/401k balance |
| rothConversionInterest | boolean | — | Interested in Roth conversion strategy? |
| socialSecurityIncome | number | — | Annual Social Security income |
| taxYear | number | yes | Tax year |
| taxableBalance | number | yes | Taxable brokerage account balance |
| traditionalBalance | number | yes | Traditional IRA/401k balance |
No output schema declared.
No examples provided.
process_1099_income ~118
Process multiple 1099 forms and calculate the tax impact of each income type. Handles 1099-NEC (freelance), 1099-INT (interest), 1099-DIV (dividends), 1099-B (investments), 1099-MISC.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | yes | — |
| forms | array | yes | Array of 1099 forms |
| taxYear | number | yes | Tax year |
| w2Income | number | — | W-2 income (for context) |
No output schema declared.
No examples provided.
run_tax_health_check ~224
One-click tax health check. Analyzes your full financial picture and outputs a report with actionable findings: missed credits, withholding accuracy, deduction optimization, audit risk, retirement savings gaps, and year-end planning tips.
| Name | Type | Req | Description |
|---|---|---|---|
| age | integer | — | — |
| boughtEV | boolean | — | — |
| capitalGains | number | — | — |
| charitableDonations | number | — | — |
| dependents | integer | — | — |
| federalWithheld | number | — | — |
| filingStatus | string | yes | — |
| grossIncome | number | yes | — |
| hasHealthInsurance | boolean | — | — |
| hsaContributions | number | — | — |
| installedSolar | boolean | — | — |
| isStudent | boolean | — | — |
| mortgageInterest | number | — | — |
| retirement401k | number | — | — |
| retirementIRA | number | — | — |
| selfEmploymentIncome | number | — | — |
| stateCode | string | — | — |
| stateLocalTaxes | number | — | — |
| taxYear | number | yes | Tax year |
| w2Income | number | — | — |
No output schema declared.
No examples provided.
simulate_tax_scenario ~243
What-if tax scenario simulator. Compare your current situation against a hypothetical change: income change, relocation, Roth conversion, filing status change, etc. Shows the exact tax impact of the change.
| Name | Type | Req | Description |
|---|---|---|---|
| currentCapitalGains | number | — | — |
| currentDependents | integer | — | — |
| currentIncome | number | yes | Current gross income |
| currentItemizedDeductions | number | — | — |
| currentSelfEmployment | number | — | — |
| currentState | string | — | Current state code |
| filingStatus | string | yes | — |
| taxYear | number | yes | Tax year |
| whatIfAdditional401k | number | — | Additional 401k contribution |
| whatIfFilingStatus | — | — | New filing status |
| whatIfIncomeChange | number | — | Income change amount (positive = more income, negative = less) |
| whatIfItemizedChange | number | — | Change in itemized deductions |
| whatIfNewDependents | integer | — | New number of dependents |
| whatIfNewState | string | — | New state if relocating |
| whatIfRothConversion | number | — | Amount to convert from Traditional to Roth IRA |
No output schema declared.
No examples provided.
standard_vs_itemized ~151
Compare standard deduction vs itemized deductions to determine which is more beneficial.
| Name | Type | Req | Description |
|---|---|---|---|
| age65OrOlder | boolean | — | — |
| agi | number | yes | Adjusted Gross Income (needed for medical expense threshold) |
| blind | boolean | — | — |
| charitableDonations | number | — | Charitable contributions |
| filingStatus | string | yes | — |
| medicalExpenses | number | — | Unreimbursed medical expenses |
| mortgageInterest | number | — | Home mortgage interest paid |
| otherItemized | number | — | Other itemized deductions |
| stateLocalTaxes | number | — | State/local income + property taxes paid |
| taxYear | number | yes | Tax year (2024 or 2025) |
No output schema declared.
No examples provided.
what_changed_between_tax_years ~105
Show all differences between two tax years — bracket changes, deduction limits, credit amounts, SALT cap, CTC, and new OBBB provisions. Great for understanding how tax law changes affect you.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | — | Filing status for specific comparisons (default: single) |
| fromYear | number | yes | Earlier tax year (e.g., 2024) |
| toYear | number | yes | Later tax year (e.g., 2025) |
No output schema declared.
No examples provided.