Skip to main content
Glama
paycheck-calculator-mcp

paycheck-calculator-mcp

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/mcp

Tools

Tool

What it does

calculate_take_home_pay

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.

compare_states_take_home

The same pay in 2 to 10 states, ranked by take-home pay, 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 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 labeled no_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/mcp

Claude Code

claude mcp add --transport http paycheck-calculator https://paycheck-calculator-mcp.lipmichal.workers.dev/mcp

Or run it locally:

claude mcp add paycheck-calculator -- npx -y paycheck-calculator-mcp

Claude 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 test

src/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

cups-to-grams-mcp

convert_ingredient, search_ingredients, scale_recipe, convert_oven_temperature

https://cups-to-grams-mcp.lipmichal.workers.dev/mcp

dscr-loan-calculator-mcp

calculate_dscr, max_loan_for_target_dscr, rent_needed_for_target_dscr, compare_scenarios, amortization_summary

https://dscr-loan-calculator-mcp.lipmichal.workers.dev/mcp

gold-price-per-gram-mcp

get_gold_price_per_gram, get_metal_prices, calculate_jewelry_value, convert_gold_units

https://gold-price-per-gram-mcp.lipmichal.workers.dev/mcp

lake-level-mcp

search_lakes, get_lake_level, get_lake_history, compare_lakes

https://lake-level-mcp.lipmichal.workers.dev/mcp

minimum-wage-mcp

get_minimum_wage, list_upcoming_increases, compare_states, annual_income_at_minimum_wage

https://minimum-wage-mcp.lipmichal.workers.dev/mcp

no-tax-on-overtime-mcp

calculate_overtime_deduction, calculate_tips_deduction, calculate_senior_deduction, estimate_tax_savings, explain_eligibility

https://no-tax-on-overtime-mcp.lipmichal.workers.dev/mcp

uk-income-tax-salary-mcp

calculate_uk_take_home, get_uk_tax_bands, compare_salaries, marginal_rate_at_income

https://uk-income-tax-salary-mcp.lipmichal.workers.dev/mcp

us-federal-holidays-business-days-mcp

list_federal_holidays, is_business_day, add_business_days, count_business_days, invoice_due_date

https://us-federal-holidays-business-days-mcp.lipmichal.workers.dev/mcp

ab-test-sample-size-calculator-mcp

calculate_sample_size, estimate_test_duration, test_ab_significance, fisher_exact_test, check_peeking_risk

https://ab-test-sample-size-calculator-mcp.lipmichal.workers.dev/mcp

aca-premium-tax-credit-calculator-mcp

get_federal_poverty_level, calculate_premium_tax_credit, check_subsidy_cliff, get_aptc_repayment_cap

https://aca-premium-tax-credit-calculator-mcp.lipmichal.workers.dev/mcp

ap-score-distributions-mcp

get_ap_score_distribution, estimate_ap_percentile, compare_ap_exams, list_ap_exams, estimate_ap_score_from_composite

https://ap-score-distributions-mcp.lipmichal.workers.dev/mcp

car-loan-interest-deduction-calculator-mcp

calculate_car_loan_interest_deduction, calculate_salt_deduction, get_tax_brackets_and_standard_deduction, calculate_child_tax_credit

https://car-loan-interest-deduction-calculator-mcp.lipmichal.workers.dev/mcp

estate-gift-tax-exemption-calculator-mcp

get_exemption_amounts, calculate_estate_tax, check_gift, compare_years

https://estate-gift-tax-exemption-calculator-mcp.lipmichal.workers.dev/mcp

recipe-nutrition-calculator-mcp

lookup_ingredient_nutrition, calculate_recipe_nutrition, round_nutrition_label, scale_recipe_nutrition

https://recipe-nutrition-calculator-mcp.lipmichal.workers.dev/mcp

retirement-contribution-limits-2027-mcp

get_contribution_limits, calculate_max_contribution, get_social_security_cola, compare_years

https://retirement-contribution-limits-2027-mcp.lipmichal.workers.dev/mcp

section-179-deduction-calculator-mcp

calculate_section_179, calculate_bonus_depreciation, get_vehicle_depreciation_limits, calculate_asset_loan_payment

https://section-179-deduction-calculator-mcp.lipmichal.workers.dev/mcp

student-loan-repayment-assistance-plan-calculator-mcp

calculate_rap_payment, compare_rap_vs_standard, get_federal_loan_limits, get_plan_transition_dates

https://student-loan-repayment-assistance-plan-calculator-mcp.lipmichal.workers.dev/mcp

subdomain-finder-mcp

find_subdomains, resolve_subdomains, get_certificate_history, summarize_attack_surface

https://subdomain-finder-mcp.lipmichal.workers.dev/mcp

uk-statutory-sick-pay-maternity-pay-calculator-mcp

calculate_statutory_sick_pay, calculate_statutory_maternity_pay, get_minimum_wage_rates, check_eligibility

https://uk-statutory-sick-pay-maternity-pay-calculator-mcp.lipmichal.workers.dev/mcp

The paid back-office collection (invoices, VAT, PDFs, spreadsheets) is at https://mcp.zovo.one

More from zovo

Available Tools

5 tools
calculate_take_home_payPaycheck calculator: take-home payA
Read-onlyIdempotent
Inspect

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 statesA
Read-onlyIdempotent
Inspect

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 deductionA
Read-onlyIdempotent
Inspect

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 salaryA
Read-onlyIdempotent
Inspect

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 rateA
Read-onlyIdempotent
Inspect

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

    A4.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      3
      52 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Answers 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      5
      68 npm
      MIT