io.github.dma9527/irs-taxpayer
NPM · IRS-TAXPAYER-MCP
45 local US tax estimation and planning tools for supported TY2024 through TY2026 scenarios.
Available components
Last scanned (3 hours ago)
Scores higher than 93% of npm servers
Category Finance and Payments
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 → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 30 of 92 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to dma9527/irs-taxpayer-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 3 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability58
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 8889 tokens (~197/item across 45 items; 45 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 Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage94
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 77% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "check_refund_status" implies "refund" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Fail
- An AI judge read all 45 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (16)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
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.
- 4 Nov 26 0
- Security disclosure: unverified → fail ▼ functional
- 3 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- Security disclosure: fail → unverified ▼ functional
- Package version: 1.2.2 → 1.2.4 functional
- 2 Nov 26 −11
- Malware scan: pass → unverified ▼ security
- CVE-2023-54404 no longer affects this package ▲ security
- CVE-2026-111767 no longer affects this package ▲ security
- CVE-2026-104850 no longer affects this package ▲ security
- CVE-2026-111768 no longer affects this package ▲ security
- CVE-2026-111771 no longer affects this package ▲ security
- CVE-2026-111769 no longer affects this package ▲ security
- GHSA-f897-62hf-6gxq no longer affects this package ▲ security
- Known CVEs: fail → pass ▲ security
- Schema quality: 171 → 195 ▼ functional
- Schema quality: 7542 → 8414 ▼ functional
- Package version: 1.1.0 → 1.2.2 functional
- Package version: 1.1.0 → 1.2.1 functional
- 1 Nov 26 +1
- Stability: 0.97 → pass security
- 31 Oct 26 −1
- Stability: pass → 0.97 functional
- 28 Oct 26 0
- GHSA-f897-62hf-6gxq affects this package: high ▼ security
- 25 Oct 26 +1
- Stability: 0.97 → pass security
- 24 Oct 26 −1
- CVE-2023-54404 affects this package: high ▼ security
- Stability: pass → 0.97 functional
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 6 Nov 2026 · Analysed npm/irs-taxpayer-mcp@1.2.4
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | dma9527/irs-taxpayer-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/dma9527/irs-taxpayer-mcp/.github/workflows/publish.yml@refs/tags/v1.2.4 |
| Rekor log index | 3659881175 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:6a5ac101429ff84ba1089bfdb42f267c8128b198994e104c7923ca4d082282f934179315029d0157c690199bcce9ae33fe922aab2eedad4c963ef408e |
Background: How many MCP packages publish verified provenance →
Dependencies 92 packages
| Packages resolved | 92 |
|---|---|
| Stale | 30 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
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. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
analyze_education_tax_benefits ~175
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 |
| taxYear | number | – | Tax year (default: 2026) |
| tuitionPaid | number | yes | Tuition and qualified expenses paid |
| yearsAOTCClaimed | integer | – | Years AOTC already claimed (max 4) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
analyze_mortgage_tax_benefit ~174
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 | Gross income, also used as MAGI because this tool does not collect MAGI adjustments |
| 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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
analyze_paycheck ~291
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 |
|---|---|---|---|
| age65OrOlder | boolean | – | Taxpayer is 65 or older |
| annualQualifiedOvertimeCompensation | number | – | TY2025+ Schedule 1-A: expected annual FLSA overtime premium |
| annualQualifiedTips | number | – | TY2025+ Schedule 1-A: expected annual qualified tips |
| 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 |
| otherDependentsForOdc | integer | – | Dependents verified for the Credit for Other Dependents |
| payFrequency | string | yes | – |
| qualifyingChildrenForCtc | integer | – | Children verified for the Child Tax Credit |
| retirement401k | number | – | 401k/403b pre-tax contribution this period |
| socialSecurityWithheld | number | – | Social Security withheld |
| spouseAge65OrOlder | boolean | – | Spouse is 65 or older |
| stateCode | string | – | – |
| stateWithheld | number | – | State tax withheld this period |
| taxYear | number | yes | Tax year |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
analyze_relocation_taxes ~155
In-depth relocation tax analysis using exact-year state profiles. Additional projection years require explicit annual federal and state data.
| 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 with explicit annual profiles (default: 1) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
calculate_eitc ~140
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, 2025, or 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
calculate_federal_tax ~1,212
Calculate federal income tax for an individual taxpayer. Supports TY2024 through TY2026. 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 |
| aotcRefundableAllowed | boolean | – | Whether refundable AOTC is allowed after under-age-24 support rules |
| aotcStudentQualifiedExpenses | array | – | Qualified AOTC expenses per already-verified eligible student |
| 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) |
| charitableCashContributions | number | – | TY2026+: qualifying cash gifts to public charities (not donor-advised funds) for the non-itemizer deduction |
| dependentCareBenefitsExcluded | number | – | Employer dependent care benefits excluded from wages (W-2 box 10) |
| dependentCareExpenses | number | – | Form 2441 work-related care expenses paid |
| dependentCareQualifyingIndividuals | integer | – | Qualifying individuals for the Child and Dependent Care Credit |
| dependents | integer | – | Legacy count of qualifying child dependents for nonrefundable CTC only |
| earlyRetirementDistributionSubjectToPenalty | number | – | Taxable early-distribution amount remaining after exceptions |
| earnedIncome | number | – | Schedule 8812 earned income used for ACTC |
| earnedIncomeCredit | number | – | EITC used by the 3-or-more-child ACTC payroll-tax method |
| filingStatus | string | yes | Filing status |
| grossIncome | number | yes | Total gross income including supplied capital gains, qualified dividends, Social Security benefits, and gross retirement distributions |
| hasForm2555 | boolean | – | Whether Form 2555 is filed, which makes ACTC unavailable |
| isoExerciseSpread | number | – | ISO stock option exercise spread (for AMT calculation) |
| itemizedCharitableContributions | number | – | TY2026+: charitable portion of itemizedDeductions, for the 0.5% of AGI floor |
| itemizedDeductions | number | – | Schedule A total after the SALT cap and medical floor, before the TY2026 charitable floor and 2/37 limit |
| lifetimeLearningQualifiedExpenses | number | – | Qualified LLC expenses not used for AOTC or another benefit |
| longTermCapitalLossCarryover | number | – | Prior-year long-term capital loss carryover as a positive amount |
| marriedFilingSeparatelyLivedWithSpouse | boolean | – | – |
| netInvestmentIncome | number | – | Total net investment income for NIIT, including taxable interest, dividends, gains, rents, royalties, and passive income |
| otherDependentsForOdc | integer | – | Dependents already verified for the nonrefundable Credit for Other Dependents |
| qualifiedBusinessIncome | number | – | Qualified Business Income for Section 199A deduction |
| qualifiedBusinessIsSstb | boolean | – | Whether the business is a specified service trade or business |
| qualifiedBusinessMaterialParticipation | boolean | – | TY2026+: taxpayer materially participates, enabling the $400 minimum QBI deduction |
| qualifiedBusinessPropertyBasis | number | – | Unadjusted basis immediately after acquisition of qualified property; pass 0 when none |
| qualifiedBusinessW2Wages | number | – | Section 199A W-2 wages; pass 0 when none |
| qualifiedDividends | number | – | Qualified dividends included in gross income, taxed at preferential rates but not netted with capital losses |
| qualifiedOvertimeCompensation | number | – | TY2025+ Schedule 1-A: FLSA overtime premium (the half of time-and-a-half) |
| qualifiedTips | number | – | TY2025+ Schedule 1-A: qualified tips from a listed tipped occupation |
| qualifiedVehicleLoanInterest | number | – | TY2025+ Schedule 1-A: interest on a loan for a new US-assembled personal vehicle |
| qualifyingChildrenForCtc | integer | – | Children already verified as CTC/ACTC qualifying children under age 17 with required SSNs |
| retirementDistributions | number | – | Gross Form 1099-R distributions included in grossIncome |
| selfEmploymentIncome | number | – | Self-employment income (Schedule C) |
| shortTermCapitalGains | number | – | Short-term capital gain or loss |
| shortTermCapitalLossCarryover | number | – | Prior-year short-term capital loss carryover as a positive amount |
| socialSecurityBenefits | number | – | Net Social Security benefits included in grossIncome |
| socialSecurityTaxesPaid | number | – | Schedule 8812 payroll-tax amount for the 3-or-more-child ACTC method |
| spouseAge65OrOlder | boolean | – | Spouse is 65 or older |
| spouseBlind | boolean | – | Spouse is blind |
| spouseEarnedIncome | number | – | MFJ only: spouse's earned income, already included in w2Income or earnedIncome |
| stateTaxDeducted | number | – | State/local taxes included in itemized deductions (for AMT) |
| taxExemptInterest | number | – | Tax-exempt interest used by the Publication 915 worksheet |
| taxYear | number | yes | Tax year (2024, 2025, or 2026) |
| taxableRetirementDistributions | number | – | Taxable Form 1099-R amount |
| w2Income | number | – | W-2 wage income |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
calculate_total_tax ~582
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 |
| aotcRefundableAllowed | boolean | – | – |
| aotcStudentQualifiedExpenses | array | – | – |
| capitalGains | number | – | Long-term capital gains |
| capitalGainsLongTerm | boolean | – | Whether capital gains are long-term (default: true) |
| dependents | integer | – | Legacy dependent count for nonrefundable CTC only |
| earlyRetirementDistributionSubjectToPenalty | number | – | – |
| earnedIncome | number | – | Schedule 8812 earned income for ACTC |
| earnedIncomeCredit | number | – | EITC used by 3-or-more-child ACTC method |
| filingStatus | string | yes | Filing status |
| grossIncome | number | yes | Total gross income including supplied capital gains, qualified dividends, Social Security benefits, and gross retirement distributions |
| hasForm2555 | boolean | – | – |
| itemizedDeductions | number | – | Total itemized deductions |
| lifetimeLearningQualifiedExpenses | number | – | – |
| longTermCapitalLossCarryover | number | – | Prior-year long-term capital loss carryover |
| marriedFilingSeparatelyLivedWithSpouse | boolean | – | – |
| netInvestmentIncome | number | – | Total net investment income used for NIIT |
| otherDependentsForOdc | integer | – | Verified dependents for ODC |
| qualifiedBusinessIncome | number | – | QBI for Section 199A deduction |
| qualifiedBusinessIsSstb | boolean | – | – |
| qualifiedBusinessPropertyBasis | number | – | – |
| qualifiedBusinessW2Wages | number | – | – |
| qualifiedDividends | number | – | Qualified dividends included in gross income |
| qualifyingChildrenForCtc | integer | – | Verified CTC/ACTC qualifying children |
| retirementDistributions | number | – | – |
| selfEmploymentIncome | number | – | Self-employment income |
| shortTermCapitalGains | number | – | Short-term capital gain or loss |
| shortTermCapitalLossCarryover | number | – | Prior-year short-term capital loss carryover |
| socialSecurityBenefits | number | – | – |
| socialSecurityTaxesPaid | number | – | Payroll-tax amount for 3-or-more-child ACTC method |
| stateCode | string | yes | Two-letter state code (e.g., 'CA', 'TX', 'NY') |
| taxExemptInterest | number | – | – |
| taxYear | number | yes | Tax year (2024, 2025, or 2026) |
| taxableRetirementDistributions | number | – | – |
| w2Income | number | – | W-2 wage income |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
calculate_w4_withholding ~169
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, 2025, or 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
check_credit_eligibility ~231
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 |
| taxYear | number | – | Tax year (default: 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
compare_filing_statuses ~93
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, 2025, or 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
compare_mfj_vs_mfs ~203
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 (maximum 20) |
| 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, 2025, or 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
compare_state_taxes ~123
Compare state income tax for one tax year only when every requested state has an explicit calculation profile.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | – | Filing status (default: single) |
| incomeBeforeStateDeductions | number | – | Annual income before modeled state deductions |
| states | array | yes | Array of state codes to compare (e.g., ['CA', 'TX', 'WA', 'NY']) |
| taxYear | integer | yes | Tax year for all versioned state calculation profiles |
| taxableIncome | number | – | Deprecated alias for incomeBeforeStateDeductions |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
estimate_premium_tax_credit ~314
Estimate the TY2026 Premium Tax Credit (Form 8962) from annual Form 1095-A totals. Uses the Rev. Proc. 2025-25 applicable percentages, the 400% poverty-line limit, and full repayment of excess advance payments.
| Name | Type | Req | Description |
|---|---|---|---|
| advancePayments | number | yes | Form 1095-A column C annual total (APTC) |
| annualBenchmarkPremium | number | yes | Form 1095-A column B annual total (SLCSP) |
| annualEnrollmentPremium | number | yes | Form 1095-A column A annual total |
| familySize | integer | yes | Tax family size (Form 8962 line 1) |
| filingStatus | string | yes | – |
| householdIncome | number | yes | Form 8962 line 3 household income (modified AGI) |
| marketplaceEstimatedAtLeast100Percent | boolean | – | Below-100% exception: the Marketplace estimated household income of at least 100% of the poverty line at enrollment |
| marriedFilingSeparatelyException2 | boolean | – | MFS only: victim of domestic abuse or spousal abandonment living apart (Form 8962 Exception 2) |
| monthly | array | – | Form 1095-A lines 21 to 32, January to December, for part-year or changing coverage; replaces the annual totals |
| povertyLineRegion | string | – | Poverty-line table (default: 48 contiguous states and DC) |
| taxYear | number | yes | Tax year (only 2026 is modeled) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
estimate_self_employment_tax ~203
Detailed self-employment tax breakdown including Schedule C profit, SE tax, QBI deduction, and recommended quarterly payments. Above the annual QBI threshold, provide SSTB classification, W-2 wages, and qualified-property basis, using 0 where none apply.
| 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 |
| qualifiedBusinessIsSstb | boolean | – | – |
| qualifiedBusinessPropertyBasis | number | – | – |
| qualifiedBusinessW2Wages | number | – | – |
| retirementContributions | number | – | SEP IRA or Solo 401k contributions |
| taxYear | number | yes | Tax year |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
estimate_state_tax ~111
Estimate state income tax using an explicit tax-year calculation profile. Unsupported state-year paths fail closed.
| Name | Type | Req | Description |
|---|---|---|---|
| filingStatus | string | – | Filing status (default: single) |
| incomeBeforeStateDeductions | number | – | State income before the modeled state standard deduction and personal exemption |
| stateCode | string | yes | Two-letter state code |
| taxYear | integer | yes | Tax year for the versioned state calculation profile |
| taxableIncome | number | – | Deprecated alias for incomeBeforeStateDeductions |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
generate_full_tax_report ~899
Generate a detailed tax estimate combining federal tax, supported state tax, FICA, modeled credits, deductions, take-home pay, and refund inputs.
| Name | Type | Req | Description |
|---|---|---|---|
| aboveTheLineDeductions | number | – | HSA, student loan interest, educator expenses, etc. |
| age65OrOlder | boolean | – | Taxpayer is 65 or older |
| aotcRefundableAllowed | boolean | – | – |
| aotcStudentQualifiedExpenses | array | – | – |
| charitableCashContributions | number | – | TY2026+: qualifying cash gifts to public charities for the non-itemizer deduction |
| charitableDonations | number | – | Charitable contributions |
| dependentCareBenefitsExcluded | number | – | Employer dependent care benefits excluded from wages (W-2 box 10) |
| dependentCareExpenses | number | – | Form 2441 work-related care expenses paid |
| dependentCareQualifyingIndividuals | integer | – | Qualifying individuals for the Child and Dependent Care Credit |
| dependents | integer | – | Children already verified as CTC, ACTC, and EITC qualifying children |
| dividendIncome | number | – | 1099-DIV ordinary dividends |
| earlyRetirementDistributionSubjectToPenalty | number | – | – |
| estimatedPaymentsMade | number | – | Estimated tax payments already made |
| federalWithheld | number | – | Federal tax already withheld YTD |
| filingStatus | string | yes | – |
| hasForm2555 | boolean | – | Whether Form 2555 is filed |
| interestIncome | number | – | 1099-INT interest income |
| lifetimeLearningQualifiedExpenses | number | – | – |
| longTermCapitalGains | number | – | Long-term capital gains/losses |
| longTermCapitalLossCarryover | number | – | Prior-year long-term capital loss carryover |
| marriedFilingSeparatelyLivedWithSpouse | boolean | – | – |
| medicalExpenses | number | – | Unreimbursed medical expenses |
| mortgageInterest | number | – | Mortgage interest |
| otherDependents | integer | – | Dependents already verified for the nonrefundable ODC |
| otherIncome | number | – | Other income (rental, alimony, etc.) |
| otherItemized | number | – | Other itemized deductions |
| qualifiedBusinessIncome | number | – | QBI for Section 199A |
| qualifiedBusinessIsSstb | boolean | – | – |
| qualifiedBusinessMaterialParticipation | boolean | – | TY2026+: materially participates, enabling the $400 minimum QBI deduction |
| qualifiedBusinessPropertyBasis | number | – | – |
| qualifiedBusinessW2Wages | number | – | – |
| qualifiedDividends | number | – | Qualified dividends (subset of dividends, taxed at CG rates) |
| qualifiedOvertimeCompensation | number | – | TY2025+ Schedule 1-A: FLSA overtime premium |
| qualifiedTips | number | – | TY2025+ Schedule 1-A: qualified tips |
| qualifiedVehicleLoanInterest | number | – | TY2025+ Schedule 1-A: interest on a new US-assembled personal vehicle loan |
| retirementDistributions | number | – | Gross Form 1099-R distributions |
| selfEmploymentIncome | number | – | Self-employment net profit |
| shortTermCapitalGains | number | – | Short-term capital gains/losses |
| shortTermCapitalLossCarryover | number | – | Prior-year short-term capital loss carryover |
| socialSecurityBenefits | number | – | Net benefits from Form SSA-1099 or RRB-1099 |
| socialSecurityTaxesPaid | number | – | Schedule 8812 payroll-tax amount for 3-or-more-child ACTC method |
| spouseAge65OrOlder | boolean | – | Spouse is 65 or older |
| spouseEarnedIncome | number | – | MFJ only: spouse's earned income, already included in W-2 or self-employment income |
| stateCode | string | – | State code for state tax estimate |
| stateLocalTaxesPaid | number | – | State/local/property taxes paid |
| stateWithheld | number | – | State tax already withheld YTD |
| taxExemptInterest | number | – | – |
| taxYear | number | yes | Tax year (2024, 2025, or 2026) |
| taxableRetirementDistributions | number | – | – |
| w2Income | number | – | W-2 wages |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
generate_tax_plan ~127
Generate a deterministic, privacy-first local tax plan with structured results, assumptions, source provenance, calculation trace, and explicit unsupported boundaries.
| Name | Type | Req | Description |
|---|---|---|---|
| business | object | – | – |
| deductions | object | – | – |
| education | object | – | – |
| family | object | – | – |
| filingStatus | string | yes | – |
| income | object | yes | Annual income facts. Qualified dividends are included in ordinary dividends. |
| payments | object | – | – |
| stateCode | string | – | – |
| taxYear | integer | yes | Tax year: 2024, 2025, or 2026 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| plan | object | – | – |
| text | string | yes | – |
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') |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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') |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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') |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
get_tax_brackets ~59
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, 2025, or 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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: 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
get_tax_document_checklist ~328
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 |
| taxYear | number | – | Tax year (default: 2026) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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.
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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') |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
How do I install the io.github.dma9527/irs-taxpayer MCP server?
io.github.dma9527/irs-taxpayer runs locally as an npm package, launched with npx -y irs-taxpayer-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · irs-taxpayer-mcp
claude mcp add dma9527-irs-taxpayer -- npx -y irs-taxpayer-mcp
What is the io.github.dma9527/irs-taxpayer MCP server?
io.github.dma9527/irs-taxpayer is an MCP server listed in the public MCP registry as io.github.dma9527/irs-taxpayer. 45 local US tax estimation and planning tools for supported TY2024 through TY2026 scenarios. This page covers its npm package (irs-taxpayer-mcp).
Is the io.github.dma9527/irs-taxpayer MCP server safe to use?
io.github.dma9527/irs-taxpayer scores 89 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 6 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.dma9527/irs-taxpayer MCP server expose?
io.github.dma9527/irs-taxpayer exposes 45 tools: calculate_federal_tax, get_tax_brackets, compare_filing_statuses, estimate_quarterly_tax, calculate_total_tax, and 40 more. Their descriptions and schemas cost roughly 8,889 tokens of context every time the server is loaded.
Is the io.github.dma9527/irs-taxpayer MCP server still maintained?
io.github.dma9527/irs-taxpayer is still listed as active in the MCP registry. We last reached this channel on 6 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.dma9527/irs-taxpayer MCP server under?
io.github.dma9527/irs-taxpayer declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the io.github.dma9527/irs-taxpayer MCP server?
VerifyMCP ran 16 checks on io.github.dma9527/irs-taxpayer, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.