Tip & Overtime Deductions
Works out the no-tax-on-tips and no-tax-on-overtime deductions and W-2 boxes, with the math shown
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"tip-overtime-w2": {
"url": "https://tip-overtime-w2.vercel.app/mcp"
}
}
}Remote endpoints
https://tip-overtime-w2.vercel.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (3)
🟢tip_overtime_deduction(tax_year, filing_status, agi, magi, valid_ssn, ...)
Works out the federal 'no tax on tips' and 'no tax on overtime' deductions (Schedule 1-A, Form 1040, tax years 2025-2028) from what the person has: W-2 box 12 code TP and TT and box 14b, Form 4137, 1099s, or pay stubs before the W-2 arrives (hours over 40 and hourly rate, or overtime pay and its multiplier). Returns each deduction with the math line by line as it goes on Schedule 1-A, the Form 1040 line it lands on, the estimated federal income tax saved, what is still unknown, a citation for every rule, and a worksheet link that opens the filled-in Schedule 1-A worksheet to print or hand to a preparer. Use for 'how much of my tips can I deduct', 'does no tax on overtime apply to me', 'what goes on Schedule 1-A', 'I made $X in tips as a server'. Only the FLSA half of time-and-a-half counts as qualified overtime. Married filing separately gets nothing. Pass dollar amounts as numbers. Filing status and income (AGI) set the phase-out and the tax-saved estimate; without them the result says what is missing instead of assuming them.
Input Schema
{
"type": "object",
"properties": {
"tax_year": {
"type": "integer",
"enum": [
2025,
2026,
2027,
2028
],
"description": "Tax year (default 2026, filed in 2027)"
},
"filing_status": {
"type": "string",
"enum": [
"single",
"mfj",
"mfs",
"hoh",
"qss"
],
"description": "single, mfj (married filing jointly), mfs (married filing separately), hoh (head of household), qss (qualifying surviving spouse)"
},
"agi": {
"type": [
"number",
"string"
],
"description": "Adjusted gross income (Form 1040 line 11b), dollars. Used as MAGI unless magi is given."
},
"magi": {
"type": [
"number",
"string"
],
"description": "Modified AGI if different: AGI plus excluded Puerto Rico / foreign earned income (Schedule 1-A line 3)"
},
"valid_ssn": {
"type": "boolean",
"description": "false if the person (or the spouse who earned the tips/overtime) has no Social Security number valid for work. Default true."
},
"jobs": {
"type": "array",
"description": "One entry per employer (W-2).",
"items": {
"type": "object",
"properties": {
"employer": {
"type": "string",
"description": "A label for the job, e.g. 'restaurant'. Not stored."
},
"box12_tp": {
"type": [
"number",
"string"
],
"description": "W-2 box 12 code TP: cash tips reported to the employer"
},
"box14b": {
"type": "string",
"description": "W-2 box 14b Treasury Tipped Occupation Code(s), e.g. '102' or '101 000'"
},
"nonqualified_tips": {
"type": [
"number",
"string"
],
"description": "Part of TP earned in an occupation NOT on the IRS list (only when 14b shows 000)"
},
"form4137_tips": {
"type": [
"number",
"string"
],
"description": "Form 4137 line 1 column (c) for this employer: all cash and charge tips received, if Form 4137 is filed"
},
"tips_paystub": {
"type": [
"number",
"string"
],
"description": "Tips from pay stubs, year to date, when there is no W-2 yet (estimate)"
},
"box12_tt": {
"type": [
"number",
"string"
],
"description": "W-2 box 12 code TT: qualified overtime"
},
"ot_hours_over_40": {
"type": "number",
"description": "Without a W-2: total hours over 40 in a workweek across the year"
},
"regular_rate": {
"type": [
"number",
"string"
],
"description": "Without a W-2: regular hourly rate, dollars"
},
"ot_pay_total": {
"type": [
"number",
"string"
],
"description": "Without a W-2: total overtime pay shown on stubs (the whole 1.5x or 2x amount)"
},
"ot_premium_paid": {
"type": [
"number",
"string"
],
"description": "Without a W-2: only the premium part above regular pay, if the stub shows it separately"
},
"ot_multiplier": {
"type": "number",
"description": "Overtime pay multiple: 1.5 (default) or 2 for double time"
},
"flsa_exempt": {
"type": "boolean",
"description": "true if exempt from FLSA overtime (e.g. salaried manager): nothing qualifies"
}
},
"additionalProperties": false
}
},
"self_employed": {
"type": "array",
"description": "Tips earned in the person's own business (1099s).",
"items": {
"type": "object",
"properties": {
"business": {
"type": "string"
},
"tips_1099": {
"type": [
"number",
"string"
],
"description": "Qualified tips shown on the 1099-NEC/MISC/K"
},
"net_profit": {
"type": [
"number",
"string"
],
"description": "Schedule C line 31 (or E/F equivalent)"
},
"other_deductions": {
"type": [
"number",
"string"
],
"description": "Other deductions allocable to that business"
}
},
"additionalProperties": false
}
},
"ot_1099": {
"type": [
"number",
"string"
],
"description": "Qualified overtime on Form 1099-NEC box 1d / 1099-MISC box 14"
}
},
"additionalProperties": false
}🟢w2_tip_overtime_boxes(tax_year, table, rows)
For an owner, bookkeeper or payroll person: works out the new 2026 Form W-2 figures for each employee from payroll rows: box 12 code TP (cash tips reported to the employer), box 12 code TT (qualified overtime: hours over 40 in each FLSA workweek x 0.5 x the regular rate, where the regular rate includes non-discretionary bonuses, tip credit and service charges paid out) and box 14b (Treasury Tipped Occupation Code, suggested from the role). Pass one row per employee per workweek, as rows or as a pasted CSV/tab table with a header (employee, week_start, hours, rate, tips, role; optional tip_credit, other_pay, service_charges, ttoc, exempt). Returns per-employee boxes, every overtime week with its math, flags, and a link to a printable sheet. W-2s for 2026 are due January 31, 2027.
Input Schema
{
"type": "object",
"properties": {
"tax_year": {
"type": "integer",
"description": "Default 2026"
},
"table": {
"type": "string",
"description": "Pasted CSV or tab-separated table with a header row"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"employee": {
"type": "string",
"description": "Name or initials (initials are fine; nothing is stored)"
},
"week_start": {
"type": "string",
"description": "First day of the FLSA workweek, YYYY-MM-DD. All rows must start on the same weekday."
},
"hours": {
"type": "number",
"description": "Hours worked in that workweek"
},
"rate": {
"type": [
"number",
"string"
]
},
"tips": {
"type": [
"number",
"string"
]
},
"tip_credit": {
"type": [
"number",
"string"
]
},
"other_pay": {
"type": [
"number",
"string"
]
},
"service_charges": {
"type": [
"number",
"string"
]
},
"role": {
"type": "string"
},
"ttoc": {
"type": "string"
},
"exempt": {
"type": "boolean"
}
},
"required": [
"employee",
"week_start",
"hours"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}🟢tipped_occupation_code(job)
Finds the Treasury Tipped Occupation Code (W-2 box 14b) for a job title, from the IRS list of 71 occupations that customarily received tips before 2025, with the IRS description and examples, the related SOC code, and what the tips deduction is worth at that occupation's median pay (BLS OEWS May 2025): federal income tax saved per $1,000 of tips and the most it can save in a year. Use for 'does my job qualify for no tax on tips', 'what is my tipped occupation code', 'is a barista a tipped occupation'. Pass a job title, or a 3-digit code.
Input Schema
{
"type": "object",
"properties": {
"job": {
"type": "string",
"description": "Job title in the user's words, or a 3-digit TTOC"
}
},
"required": [
"job"
],
"additionalProperties": false
}Community
Evidence