paycheck-calculator-mcp
Summary: A paycheck calculator MCP server that computes US take-home pay for tax years 2025 and 2026 across all 50 states and DC, with no sign-in required.
calculate_take_home_pay— Net pay per period and per year from annual or per-period gross, pay frequency, filing status, state and tax year; returns federal income tax, Social Security (with wage base), Medicare plus 0.9% Additional Medicare, and state tax with the method used. Handles pre-tax 401(k) and payroll HSA contributions.compare_states_take_home— Runs the same pay through 2–10 states, ranked by annual take-home, with each state's tax and method.salary_to_hourly— Annual salary to hourly, weekly, biweekly, semimonthly and monthly gross pay.hourly_to_salary— Hourly wage, with optional overtime hours and multiplier, to weekly, monthly and annual gross pay.get_federal_tax_brackets— Exact federal brackets and standard deduction for 2025/2026 by filing status, plus the Social Security wage base and Medicare thresholds.Every result includes structured JSON, a plain-English summary,
as_of,source, and amorelink to the matching calculator page.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@paycheck-calculator-mcp What's my biweekly take-home on $85,000 in California, single, in 2026?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
paycheck-calculator-mcp
A paycheck calculator MCP server: take-home pay for tax years 2025 and 2026 with the IRS bracket tables, the One Big Beautiful Bill Act standard deduction, the Social Security wage base, Additional Medicare tax and state income tax for all 50 states and DC.
Hosted endpoint, no sign-in and no token:
https://paycheck-calculator-mcp.lipmichal.workers.dev/mcpTools
Tool | What it does |
| Net pay per period and per year from annual or per-period gross pay, pay frequency, filing status, state and tax year. Returns federal income tax, Social Security (with the wage base), Medicare plus the 0.9% Additional Medicare tax, state income tax and the method used for it. Handles pre-tax 401(k) and payroll HSA contributions. |
| The same pay in 2 to 10 states, ranked by take-home pay, with each state's tax and method. |
| Annual salary to hourly, weekly, biweekly, semimonthly and monthly gross pay. |
| Hourly wage, with optional overtime hours and multiplier, to weekly, monthly and annual gross pay. |
| Exact federal brackets and standard deduction for 2025 or 2026 and a filing status, plus the Social Security wage base and Medicare thresholds. |
Every result has structured JSON, a plain-English summary, as_of, source (the irs.gov or state revenue document) and more (the matching calculator page on statewage.com).
Related MCP server: Tools Berry MCP Server
What it knows that your model does not
The 2025 standard deduction changed mid-year. P.L. 119-21 (signed July 4, 2025) raised it to $15,750 single, $31,500 joint and $23,625 head of household, replacing the $15,000 / $30,000 / $22,500 in Rev. Proc. 2024-40.
The 2026 brackets and standard deduction ($16,100 / $32,200 / $24,150) from Rev. Proc. 2025-32.
The Social Security wage base: $176,100 for 2025 and $184,500 for 2026.
Additional Medicare tax is owed over $200,000 single, $250,000 joint and $125,000 separate, but employers withhold it over $200,000 for everyone. The tool returns both.
A 401(k) deferral lowers income tax but not Social Security or Medicare. A payroll HSA contribution lowers all three.
Exact 2026 state schedules for California, New York, New Jersey, Illinois, Pennsylvania, Georgia and North Carolina, including each state's deductions or exemptions and its treatment of 401(k) and HSA money (Pennsylvania taxes 401(k) deferrals; California and New Jersey tax HSA contributions). New York's 2026 rate cuts and its tax-benefit recapture over $107,650 are included.
Michigan, Virginia and Ohio run through their own schedules and exemptions, but are labeled
method: "estimate"until their 2026 sources are re-checked (see Limitations).Every other state's figure is a single-rate estimate and is labeled
method: "estimate". States with no wage income tax are labeledno_wage_income_tax.
Install
Claude.ai custom connector or ChatGPT developer mode
Add a custom connector and paste the URL. No token is needed.
https://paycheck-calculator-mcp.lipmichal.workers.dev/mcpClaude Code
claude mcp add --transport http paycheck-calculator https://paycheck-calculator-mcp.lipmichal.workers.dev/mcpOr run it locally:
claude mcp add paycheck-calculator -- npx -y paycheck-calculator-mcpClaude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"paycheck-calculator": {
"command": "npx",
"args": ["-y", "paycheck-calculator-mcp"]
}
}
}Cursor
Add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"paycheck-calculator": {
"url": "https://paycheck-calculator-mcp.lipmichal.workers.dev/mcp"
}
}
}VS Code
Add this to .vscode/mcp.json:
{
"servers": {
"paycheck-calculator": {
"type": "http",
"url": "https://paycheck-calculator-mcp.lipmichal.workers.dev/mcp"
}
}
}Node 20 or newer is needed for the local npx version.
Example prompts
"I make $85,000 a year in California, single, paid biweekly. What is my take-home pay per paycheck in 2026?"
"Compare my take-home on a $120,000 salary in Texas, New York, New Jersey and Washington. We file jointly."
"If I put 6% into my 401(k) and $3,000 into an HSA, how much does my paycheck drop in Pennsylvania?"
"What are the 2025 federal tax brackets for head of household, and what is the standard deduction?"
"I earn $32 an hour with 5 hours of overtime a week. What is that as a salary?"
Data sources
Federal numbers come from irs.gov documents fetched on 2026-10-30: Rev. Proc. 2024-40, Rev. Proc. 2025-32, Publication 15 (2025 and 2026), Topic 751, the Form 8959 instructions and Publication 15-B. State schedules come from each state's revenue department. See DATA_SOURCES.md for each item and URL.
Limitations
Results are estimates of the annual tax on wages, not tax advice. They are not your employer's W-4 withholding.
The pay is treated as the household's only income, with the standard deduction and no credits.
Local income taxes are out of scope: New York City, Yonkers, Ohio city and school district taxes, Pennsylvania local earned income tax, Maryland and Indiana county taxes, Michigan city taxes and others.
State payroll taxes such as California SDI and New Jersey SUI, DI and FLI are not included.
State figures outside the seven exact states are estimates. Michigan and Virginia use their published schedules, but the state sites could not be fetched to confirm them. Ohio's 2026 statute and its 2026 forms disagree; the statute is used. For 2025 requests, the exact states use their 2026 schedule and are labeled estimates.
More
Paycheck calculators for every state: statewage.com.
Part of the Zovo MCP collection: https://mcp.zovo.one
Development
npm install
npm run build
npm testsrc/core.ts holds the paycheck logic and has no I/O. src/federal.ts holds the IRS tables, src/states-exact.ts the exact state schedules and src/state-table.ts the estimates. src/stdio.ts is the local entry and src/worker.ts is the Cloudflare Worker entry. Both use the same tool registry in src/tools.ts.
License
MIT
More data servers from the same author
Each one is free, needs no API key and has a hosted URL you can paste into Claude or ChatGPT.
server | tools | hosted URL |
convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature |
| |
calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary |
| |
get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units |
| |
search_lakes, get_lake_level, get_lake_history, compare_lakes |
| |
get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage |
| |
calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility |
| |
calculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_income |
| |
list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date |
| |
calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk |
| |
get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap |
| |
get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite |
| |
calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit |
| |
get_exemption_amounts, calculate_estate_tax, check_gift, compare_years |
| |
lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition |
| |
get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years |
| |
calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment |
| |
calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates |
| |
find_subdomains, resolve_subdomains, get_certificate_history, summarize_attack_surface |
| |
calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility |
|
The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one
More from zovo
All free zovo VS Code extensions - file viewers, database clients, formatters. Offline, no telemetry, no sign-up.
Full MCP server catalogue - local-first MCP servers for back-office work: invoices, VAT, PDFs, spreadsheets, payroll.
Hosted no-install MCP endpoints - paste a URL in Claude / Cursor, nothing to install.
Available Tools
5 toolscalculate_take_home_payPaycheck calculator: take-home payARead-onlyIdempotentInspect
Calculates take-home (net) pay for a US employee in any of the 50 states or DC for tax year 2025 or 2026: federal income tax from the IRS Rev. Proc. 2024-40 / 2025-32 bracket tables with the One Big Beautiful Bill Act standard deduction ($15,750 single for 2025, $16,100 for 2026), Social Security with the wage base ($176,100 in 2025, $184,500 in 2026), Medicare plus the 0.9% Additional Medicare tax, and state income tax. State tax is exact from each state's 2026 schedule for CA, NY, NJ, IL, PA, GA, NC; other states return a labeled effective-rate estimate (method: "estimate"). Handles pre-tax 401(k) (not FICA-exempt) and payroll HSA (FICA-exempt), and Pennsylvania/New Jersey rules that tax 401(k) or HSA money. Returns per-period and annual figures. Local taxes (NYC etc.) are out of scope. Figures copied from irs.gov and state revenue sites in Oct 2026.
Inputs: state (required), tax_year (required), filing_status (required), hsa_annual, +5 more.
compare_states_take_homeCompare take-home pay across statesARead-onlyIdempotentInspect
Runs the same gross pay through 2 to 10 states (or DC) and ranks them by annual take-home pay for tax year 2025 or 2026, showing state income tax, the method for each state (exact 2026 schedule for CA, NY, NJ, IL, PA, GA, NC; labeled estimate elsewhere; no wage income tax in AK, FL, NV, NH, SD, TN, TX, WA, WY) and how far each trails the best. Federal tax and FICA use the IRS 2025/2026 tables and wage base. Use it for relocation and remote-work offers.
Inputs: states (required), tax_year (required), filing_status (required), hsa_annual, +5 more.
get_federal_tax_bracketsFederal income tax brackets and standard deductionARead-onlyIdempotentInspect
Returns the exact federal income tax brackets (rate, lower and upper bound, tax on lower brackets) and standard deduction for tax year 2025 or 2026 and a filing status, from IRS Rev. Proc. 2024-40 and Rev. Proc. 2025-32, including the One Big Beautiful Bill Act (P.L. 119-21) standard deduction increase for 2025 ($15,750 / $31,500 / $23,625). Also returns the Social Security wage base and Medicare thresholds for that year.
Inputs: tax_year (required), filing_status (required).
hourly_to_salaryHourly rate to annual salaryARead-onlyIdempotentInspect
Converts an hourly wage to weekly, monthly and annual gross pay, with optional weekly overtime hours at a multiplier (1.5 by default). Defaults: 40 hours a week, 52 weeks. Gross pay only; use calculate_take_home_pay for net.
Inputs: hourly_rate (required), hours_per_week, weeks_per_year, overtime_multiplier, +1 more.
salary_to_hourlySalary to hourly rateARead-onlyIdempotentInspect
Converts an annual salary to an hourly rate and to weekly, biweekly (26), semimonthly (24) and monthly gross pay. Defaults: 40 hours a week, 52 weeks (2,080 hours). Gross pay only; use calculate_take_home_pay for net.
Inputs: annual_salary (required), hours_per_week, weeks_per_year.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: net pay calculation, multi-state comparison, two salary/hourly conversion directions, and federal bracket lookup. The boundaries are explicit, and the descriptions reinforce when to use each tool. No two tools appear to compete for the same request.
All names use snake_case and are descriptive, but the set mixes verb_noun patterns (calculate_take_home_pay, compare_states_take_home, get_federal_tax_brackets) with conversion patterns (salary_to_hourly, hourly_to_salary). The deviations are minor and still highly readable.
Five tools is well-scoped for a paycheck calculator: one core calculator, one comparison tool, two conversion helpers, and one reference lookup. Each tool earns its place without obvious redundancy.
The surface covers net pay calculation, state comparison, salary/hourly conversions, and federal bracket lookup, which are the core workflows for this domain. Local taxes are explicitly out of scope, and some niche payroll cases are not covered, but agents can work around these limitations.
Maintenance
Related MCP Connectors
Live US paycheck and payroll-tax math for 2026, all 50 states and DC, powered by tools-berry.com.
Read-only 2026 paycheck estimates for CA, NY, IL, TX, FL, plus hourly-to-salary. Not tax advice.
US take-home pay after federal, FICA and state taxes, all 50 states and DC.
US federal 2026 tax brackets, standard deductions, payroll and retirement limits, sourced.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to compute US take-home pay, self-employment taxes, and capital gains taxes for the 2026 tax year using the engine from statetakehome.com.352 npmMIT
- AlicenseNot gradedqualityCmaintenanceAnswers US paycheck and payroll-tax questions for 2026 with real arithmetic, including take-home pay, bonus withholding, state comparisons, and per-state rate schedules for all 50 states and DC.MIT
- AlicenseNot gradedqualityCmaintenanceEnables models to query real US government data (BLS, BEA, Census, IRS 2026) to calculate 2026 take-home pay across all 50 states plus DC, compare cost-of-living-adjusted salaries between 50 US metros, retrieve tax bracket ladders, and look up occupation-level salary percentiles. Exposes five read-only tools over a free, keyless remote Streamable HTTP endpoint.MIT
- AlicenseAqualityCmaintenanceEnables calculation of the 2025-2028 federal overtime, tips, and senior deductions — applying IRS caps, MAGI phase-outs, and bracket tables — plus eligibility explanations and estimated federal tax savings.568 npmMIT