io.github.dma9527/irs-taxpayer
NPM · IRS-TAXPAYER-MCP · SCANNED SEP 21
44 local US tax estimation and planning tools for supported TY2024 through TY2026 scenarios.
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 → 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
- 31 of 96 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 2 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability61
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 7542 tokens (~171/item across 44 items; 44 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 Management94
- Stability check failed: the tool surface changed between 0.5.3 and 1.1.0: 0 tool removals, 2 breaking changes, 2 additions. See how to fix → Fail
Tool Coverage93
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 75% 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 44 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
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
{
"mcpServers": {
"dma9527-irs-taxpayer": {
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
} {
"servers": {
"dma9527-irs-taxpayer": {
"command": "npx",
"args": [
"-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": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"irs-taxpayer-mcp"
]
}
}
} assistant mcp add dma9527-irs-taxpayer -t stdio -c npx -a -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.
- 21 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 91 to 94.
- 19 Sept 26 +16
- Malware scan: unverified → pass ▲ security
- 18 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- Package version: 1.0.2 → 1.1.0 functional
- 16 Sept 26 −2
No change was recorded against any check on this day. Stability & Change Management went from 98 to 78.
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 91 to 94.
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 84 to 88.
- 10 Sept 26 −2
No change was recorded against any check on this day. Stability & Change Management went from 98 to 81.
- 9 Sept 26 +15
- Malware scan: unverified → pass ▲ security
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 21 Sept 2026 · Analysed npm/irs-taxpayer-mcp@1.1.0
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.1.0 |
| Rekor log index | 2886136455 |
| Predicate type | https://slsa.dev/provenance/v1 |
| Subject digest | sha512:5f841c9799355d26aff7b5c4975c9c169cc222545e6f9fcf35ebe1f099430f7e707d1ca2e5c0243fe773312cc186ddd0e0d75dd5f87615e812c501ec9 |
Background: How many MCP packages publish verified provenance →
Dependencies 96 packages
| Packages resolved | 96 |
|---|---|
| Stale | 31 |
| 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 ~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) |
| 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 ~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 |
| 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 ~892
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) |
| 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) |
| itemizedDeductions | number | – | Total itemized deductions (if greater than standard deduction) |
| 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 |
| 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 |
| 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 |
| 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 ~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 |
| 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_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 ~646
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. |
| aotcRefundableAllowed | boolean | – | – |
| aotcStudentQualifiedExpenses | array | – | – |
| charitableDonations | number | – | Charitable contributions |
| 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 | – | – |
| qualifiedBusinessPropertyBasis | number | – | – |
| qualifiedBusinessW2Wages | number | – | – |
| qualifiedDividends | number | – | Qualified dividends (subset of dividends, taxed at CG rates) |
| 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 |
| 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 ~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 |
| 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.
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
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 |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
process_1099_income ~176
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 |
| longTermCapitalLossCarryover | number | – | – |
| qualifiedBusinessIsSstb | boolean | – | – |
| qualifiedBusinessPropertyBasis | number | – | – |
| qualifiedBusinessW2Wages | number | – | – |
| shortTermCapitalLossCarryover | number | – | – |
| taxYear | number | yes | Tax year |
| w2Income | number | – | W-2 income (for context) |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| isError | boolean | yes | – |
| text | string | yes | – |
No examples provided.
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. 44 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 21 September 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 44 tools: calculate_federal_tax, get_tax_brackets, compare_filing_statuses, estimate_quarterly_tax, calculate_total_tax, and 39 more. Their descriptions and schemas cost roughly 7,542 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 21 September 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.