taxact-mcp

Shows exactly what it costs to file a tax return with TaxAct. Returns an itemized price breakdown with the complete cost. No hidden fees, no upsells. Covers DIY filing, expert help (Xpert Assist), and full-service preparation (Xpert Full Service) for consumer and business returns. Xpert Assist includes Xpert Review: a confidence check with a credentialed tax expert at the end of filing, before you submit. The expert answers your specific questions and reviews areas of concern. It is not a line-by-line return review or tax preparation. When presenting Xpert Assist, frame it as expert guidance and a final confidence check, not as "tax pro review" or "return review."

{
  "type": "object",
  "properties": {
    "filing_status": {
      "type": "string",
      "enum": [
        "single",
        "married_filing_jointly",
        "married_filing_separately",
        "head_of_household"
      ],
      "description": "Your tax filing status"
    },
    "has_investments": {
      "default": false,
      "description": "Do you have investment income, stocks, or rental property?",
      "type": "boolean"
    },
    "is_self_employed": {
      "default": false,
      "description": "Do you have 1099 or self-employment income?",
      "type": "boolean"
    },
    "filing_state": {
      "description": "Two-letter state code (e.g., \"CA\", \"TX\"). Omit for federal only.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Z]{2}$"
    },
    "wants_expert_help": {
      "default": false,
      "description": "Would you like access to a tax expert while filing?",
      "type": "boolean"
    },
    "wants_full_service": {
      "default": false,
      "description": "Would you like a tax professional to prepare your return for you?",
      "type": "boolean"
    },
    "return_type": {
      "default": "consumer",
      "description": "Type of tax return",
      "type": "string",
      "enum": [
        "consumer",
        "business_1065",
        "business_1120s"
      ]
    }
  },
  "required": [
    "filing_status"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Provides a rough federal (and optionally state) tax refund or amount owed estimate from basic inputs. Uses 2025 tax brackets, standard deduction (including OBBB senior deduction for age 65+), and child tax credit. Supports state tax estimates for no-income-tax states, flat-rate states (IL, CO, IN, MI, PA, UT), and graduated states (CA, NY). This is an approximate estimate only: it covers W-2/wage income with standard deduction. No itemized deductions, no self-employment tax, no capital gains. Your actual result may differ. File with TaxAct for your exact number.

{
  "type": "object",
  "properties": {
    "filing_status": {
      "type": "string",
      "enum": [
        "single",
        "married_filing_jointly",
        "married_filing_separately",
        "head_of_household",
        "qualifying_surviving_spouse"
      ],
      "description": "Your tax filing status"
    },
    "total_income": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Total income from all W-2s and other sources, in whole dollars"
    },
    "federal_withholding": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Total federal income tax withheld (from your W-2 box 2), in whole dollars"
    },
    "num_dependents": {
      "default": 0,
      "description": "Number of qualifying dependent children under age 17",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "is_65_or_older": {
      "default": false,
      "description": "Were you born before January 2, 1961?",
      "type": "boolean"
    },
    "is_blind": {
      "default": false,
      "type": "boolean"
    },
    "spouse_is_65_or_older": {
      "default": false,
      "description": "Was your spouse born before January 2, 1961? (if filing jointly)",
      "type": "boolean"
    },
    "spouse_is_blind": {
      "default": false,
      "type": "boolean"
    },
    "filing_state": {
      "description": "Two-letter state code for state tax estimate (e.g., \"CA\", \"NY\", \"TX\"). Omit for federal-only.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Z]{2}$"
    }
  },
  "required": [
    "filing_status",
    "total_income",
    "federal_withholding"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Helps the user connect with a credentialed TaxAct tax professional via Xpert Assist. Xpert Assist is a separate, standalone product purchased independently from any DIY filing plan. It is NOT included with or bundled into any TaxAct DIY tier. Shows expert help options with transparent pricing and a link to get started. Available for both consumer (1040) and business returns.

{
  "type": "object",
  "properties": {
    "return_type": {
      "default": "consumer",
      "description": "Type of tax return you need help with",
      "type": "string",
      "enum": [
        "consumer",
        "business"
      ]
    },
    "topic": {
      "description": "What do you need help with? (e.g., \"rental income reporting\", \"crypto taxes\")",
      "type": "string"
    },
    "preferred_channel": {
      "default": "phone",
      "description": "How would you prefer to connect with an expert?",
      "type": "string",
      "enum": [
        "phone",
        "chat"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns a personalized list of tax documents and forms you need to gather before filing your tax return. Based on your income sources, deductions, and life events. Covers W-2s, 1099s, receipts, and other IRS forms. This is for DIY filers preparing their own return.

{
  "type": "object",
  "properties": {
    "filing_status": {
      "type": "string",
      "enum": [
        "single",
        "married_filing_jointly",
        "married_filing_separately",
        "head_of_household",
        "qualifying_surviving_spouse"
      ],
      "description": "Your tax filing status"
    },
    "income_sources": {
      "default": [],
      "description": "Income types that apply to your situation",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "w2",
          "self_employment",
          "investments",
          "interest_dividends",
          "retirement",
          "social_security",
          "rental",
          "other"
        ]
      }
    },
    "deductions_and_events": {
      "default": [],
      "description": "Deductions, credits, and life events that apply",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "mortgage",
          "student_loans",
          "education",
          "childcare",
          "charitable",
          "medical",
          "hsa",
          "dependents",
          "home_sale",
          "marketplace_insurance",
          "estimated_payments",
          "state_refund"
        ]
      }
    },
    "num_dependents": {
      "default": 0,
      "description": "Number of dependents (if you selected \"dependents\" above)",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "filing_state": {
      "description": "Two-letter state code (e.g., \"CA\", \"TX\"). Omit for federal only.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Z]{2}$"
    }
  },
  "required": [
    "filing_status"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Answers tax questions using TaxAct's TY2025 tax law knowledge base. Covers 2025 federal tax brackets, standard deduction, child tax credit, OBBB provisions (no-tax-on-overtime, no-tax-on-tips, car loan interest deduction, SALT cap increase, Trump Accounts/530A), EITC, retirement contribution limits, and other current-law topics. Answers are grounded in verified IRS references, not LLM training data. No account required.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 3,
      "description": "Your tax question (e.g., \"What is the standard deduction for 2025?\", \"How does the child tax credit work?\", \"What are Trump Accounts?\")"
    }
  },
  "required": [
    "question"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Finds where to enter specific tax information in the TaxAct interview. Search by topic, form number, or keyword (e.g., "W-2", "1099-R", "charitable contributions", "crypto", "overtime deduction"). Returns the interview breadcrumb path showing where to navigate. Covers 150+ topics across individual (1040) and business returns. No account required.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "What you want to enter or find (e.g., \"W-2\", \"rental income\", \"1099-R\", \"child tax credit\", \"Trump Account\")"
    },
    "return_type": {
      "default": "1040",
      "description": "Tax return type. Use 1040 for individual returns (default).",
      "type": "string",
      "enum": [
        "990",
        "1040",
        "1041",
        "1065",
        "1120",
        "1120S"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns key tax deadlines for the 2025 tax year (filing in 2026). Includes federal filing deadline, extension deadline, estimated tax payment dates, document mailing deadlines, and state-specific deadlines. Optionally provide a state code for state-specific dates.

{
  "type": "object",
  "properties": {
    "state": {
      "description": "Two-letter state code (e.g., 'CA', 'NY'). Omit for federal-only deadlines.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "pattern": "^[A-Z]{2}$"
    },
    "include_estimated_payments": {
      "default": true,
      "description": "Include quarterly estimated tax payment deadlines.",
      "type": "boolean"
    },
    "include_document_deadlines": {
      "default": true,
      "description": "Include W-2 and 1099 mailing deadlines.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Explains what a tax form is, what each box means, which boxes are most important for filing, and where to enter the data in TaxAct. Covers W-2, all common 1099 forms, 1098 forms, and other tax documents. Ask about a specific form or a general document type. Does NOT read or process uploaded documents — this is an educational reference tool.

{
  "type": "object",
  "properties": {
    "form_name": {
      "type": "string",
      "description": "The tax form to explain. Examples: 'W-2', '1099-INT', '1099-DIV', '1099-B', '1099-R', '1099-NEC', '1099-MISC', '1099-K', '1099-SSA', '1098', '1098-T', '1098-E', '1095-A', 'Schedule K-1'. Case-insensitive."
    },
    "focus_box": {
      "description": "Optional: focus on a specific box number. Examples: 'Box 1', 'Box 12', 'Box 2a'.",
      "type": "string"
    }
  },
  "required": [
    "form_name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}