Paycheck Calculator MCP tool

MCP findutils:paycheck_calculator

Estimate United States take-home pay from a gross salary: federal income tax using the published bracket tables and the standard deduction, plus the employee half of FICA — 6.2% Social Security up to the annual wage base, 1.45% Medicare on everything, and the additional 0.9% Medicare tax above the threshold for your filing status. Traditional 401(k) contributions reduce income tax but not FICA; cafeteria-plan contributions such as an HSA or health premiums reduce both, which is why they are separate inputs. Covers the tax years in the published tables. State and local income tax are NOT included, so the result is an upper bound on take-home for anyone in a state that taxes wages.

Open the tool Try it

Arguments

application/json

gross_pay

number required

Gross pay for one pay period, before any deduction.
pay_frequency

string optional

How often you are paid. biweekly is every two weeks (26 a year); semimonthly is twice a month (24). Default biweekly. One of weekly · biweekly · semimonthly · monthly · annual. Default "biweekly".
filing_status

string optional

Federal filing status. Default single. One of single · married_joint · married_separate · head_of_household. Default "single".
tax_year

string optional

Tax year to use. Default 2025. One of 2024 · 2025. Default "2025".
retirement_401k

number optional

Traditional 401(k) or 403(b) contribution per pay period. Reduces federal income tax; does not reduce Social Security or Medicare. Default 0. Default 0.
cafeteria_plan

number optional

Section 125 cafeteria-plan contribution per pay period — HSA, FSA or health insurance premiums. Reduces federal income tax AND FICA. Default 0. Default 0.
extra_withholding

number optional

Additional federal withholding per pay period, from step 4(c) of Form W-4. Default 0. Default 0.

Example arguments

Verified

{
  "gross_pay": 4000,
  "pay_frequency": "biweekly",
  "filing_status": "single",
  "tax_year": "2025"
}

claude mcp add findutils --transport http https://mcp.findutils.com/

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "paycheck_calculator",
      "arguments": {
        "gross_pay": 4000,
        "pay_frequency": "biweekly",
        "filing_status": "single",
        "tax_year": "2025"
      }
    }
  }'

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/paycheck-calculator/execute.

REST reference

Rate limit: 120 a minute, per IP
Auth: None
REST id: paycheck-calculator
MCP name: paycheck_calculator
Category: Finance
Machine-readable: openapi.json · markdown.md

Arguments

Example arguments

More Finance tools

More to explore