irs-taxpayer-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calculate_federal_taxA | 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. |
| get_tax_bracketsA | Get federal income tax brackets and standard deduction for a given tax year and filing status. |
| compare_filing_statusesA | Compare tax liability across different filing statuses for the same income. Helps determine the most advantageous filing status. |
| estimate_quarterly_taxA | Calculate estimated quarterly tax payments (Form 1040-ES) for self-employed or other taxpayers who need to make estimated payments. |
| calculate_total_taxA | Calculate combined federal + state tax for a complete picture of total tax liability. Returns federal breakdown, state tax, and combined totals in one call. |
| calculate_w4_withholdingA | Calculate recommended W-4 withholding settings. Estimates per-paycheck federal tax and provides step-by-step W-4 form recommendations. |
| list_deductionsA | List available tax deductions with eligibility rules and limits. Covers both above-the-line and itemized deductions. |
| standard_vs_itemizedB | Compare standard deduction vs itemized deductions to determine which is more beneficial. |
| get_tax_deadlinesB | Get important IRS tax deadlines and due dates for a given tax year. |
| check_refund_statusA | Provide instructions on how to check IRS refund status. This tool does NOT access your IRS account — it provides the official links and requirements. |
| get_irs_form_infoA | Get information about common IRS tax forms — what they are, who needs them, and where to find them. |
| list_tax_creditsA | List available federal tax credits with eligibility, amounts, and phase-out rules. Covers family, education, energy, retirement, healthcare, and income-based credits. |
| check_credit_eligibilityA | Check which tax credits you may be eligible for based on your situation. |
| get_retirement_accountsA | Get details on retirement account types — contribution limits, tax treatment, income limits, and tips. |
| get_retirement_strategyA | Get detailed info on tax-advantaged retirement strategies like Backdoor Roth, Mega Backdoor Roth, Roth Conversion Ladder, Tax Loss/Gain Harvesting. |
| calculate_eitcA | Calculate the exact Earned Income Tax Credit (EITC) amount. The EITC is one of the largest refundable credits for low-to-moderate income workers. |
| get_state_tax_infoB | Get state income tax information — rates, brackets, and key details for any US state. |
| estimate_state_taxA | Estimate state income tax using an explicit tax-year calculation profile. Unsupported state-year paths fail closed. |
| compare_state_taxesA | Compare state income tax for one tax year only when every requested state has an explicit calculation profile. |
| list_no_income_tax_statesA | List all US states with no state income tax. |
| get_tax_planning_tipsB | Get personalized year-end tax optimization strategies based on your income, deductions, and situation. Suggests actions to reduce tax liability before year-end. |
| compare_tax_yearsA | Compare tax liability across different tax years for the same income. Shows how bracket changes and inflation adjustments affect your tax. |
| estimate_self_employment_taxA | 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. |
| analyze_mortgage_tax_benefitA | Analyze the tax benefit of mortgage interest deduction and property taxes. Compares itemizing with mortgage vs taking the standard deduction. |
| analyze_education_tax_benefitsA | Compare education tax benefits: AOTC vs Lifetime Learning Credit, student loan interest deduction, and 529 plan advantages. |
| compare_mfj_vs_mfsA | Compare Married Filing Jointly (MFJ) vs Married Filing Separately (MFS). Shows tax difference and lists all MFS restrictions that may affect your situation. |
| calculate_obbb_deductionsA | 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. |
| what_changed_between_tax_yearsB | Show all differences between two tax years — bracket changes, deduction limits, credit amounts, SALT cap, CTC, and new OBBB provisions. Great for understanding how tax law changes affect you. |
| generate_full_tax_reportB | Generate a detailed tax estimate combining federal tax, supported state tax, FICA, modeled credits, deductions, take-home pay, and refund inputs. |
| process_1099_incomeB | 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. |
| get_personalized_tax_calendarA | Generate a personalized tax calendar based on your situation. Shows deadlines for filing, estimated payments, extensions, and key actions. |
| analyze_paycheckA | Analyze a paycheck to verify withholding accuracy. Input your pay stub numbers and see if your employer is withholding the right amount. |
| simulate_tax_scenarioA | What-if tax scenario simulator. Compare your current situation against a hypothetical change: income change, relocation, Roth conversion, filing status change, etc. Shows the exact tax impact of the change. |
| assess_audit_riskA | 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. |
| get_tax_document_checklistA | Generate a personalized checklist of tax documents you need to gather for filing. Based on your income sources, deductions, and life events. |
| optimize_capital_gainsA | 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. |
| plan_retirement_withdrawalsA | Plan tax-efficient retirement withdrawals. Determines optimal order to draw from Traditional IRA, Roth IRA, and taxable accounts to minimize lifetime tax. |
| plan_multi_year_taxesA | Create a 3-5 year tax projection and strategy. Models income changes, Roth conversions, retirement contributions, and bracket management across multiple years. |
| analyze_relocation_taxesB | In-depth relocation tax analysis using exact-year state profiles. Additional projection years require explicit annual federal and state data. |
| run_tax_health_checkA | One-click tax health check. Analyzes your full financial picture and outputs a report with actionable findings: missed credits, withholding accuracy, deduction optimization, audit risk, retirement savings gaps, and year-end planning tips. |
| lookup_tax_ruleA | Look up IRS tax rules, definitions, and common questions. Covers filing rules, income types, deduction rules, credit eligibility, stock options, wash sales, and more. |
| get_form_filing_guideA | 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. |
| submit_feedbackA | Generate a pre-filled GitHub Issue URL for reporting calculation errors or data issues. No data is sent. The user clicks the link to submit. Use this after verifying the user's inputs. |
| generate_tax_planA | Generate a deterministic, privacy-first local tax plan with structured results, assumptions, source provenance, calculation trace, and explicit unsupported boundaries. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 44 tools
Many tools are individually well-described, but the set has significant boundary overlap: calculate_total_tax, generate_full_tax_report, generate_tax_plan, run_tax_health_check, and simulate_tax_scenario all perform broad tax computations. Also, get_tax_deadlines vs get_personalized_tax_calendar and get_state_tax_info vs estimate_state_tax create ambiguity. An agent would struggle to reliably pick the right tool for a general tax question.
The vast majority of tools follow a consistent snake_case verb_noun pattern such as calculate_federal_tax, list_tax_credits, compare_state_taxes, and analyze_paycheck. The main deviations are noun-phrase names like standard_vs_itemized and what_changed_between_tax_years, plus inconsistent use of calculate vs estimate for similar operations. Overall the convention is still predictable and readable.
At 44 tools, this server is well into the 'too many' range and far beyond the typical well-scoped MCP surface. While the tax domain is broad, many tools are narrow one-off calculators that could be consolidated into parameterized tools, reducing cognitive load without losing capability.
The tool set is unusually comprehensive for individual taxpayer assistance, covering federal and state tax calculation, credits, deductions, W-4 withholding, quarterly estimates, retirement, capital gains, relocation, audit risk, and forms/deadlines. Minor gaps include no actual return preparation or filing submission, no explicit AMT tool, and unsupported state-year calculation paths. These are workable limitations rather than dead ends.