StateTakeHome

statetakehome-mcp

一款 Model Context Protocol（MCP）服务，让你的 AI 助手可以直接使用完整的美国工资税计算引擎：联邦税率档、全部 50 个州及 DC、FICA、自雇税和资本利得税，全部适用于 2026 纳税年度，且数据均来自为 statetakehome.com 提供支持的同一套引擎。

与众不同之处： 大多数实得工资计算器只计算“总收入减去税款”。这款工具还了解 2026 年 OBBBA（One Big Beautiful Bill Act） 的影响——它内置的当年联邦税率档和门槛已反映 OBBBA 实施后的基准，因此随着影响 2026 纳税年度的规则逐步推出，估算结果依然准确。

快速开始

无需安装——使用 npx 运行即可。

Claude Desktop / Claude Code

添加到你的 MCP 配置文件（claude_desktop_config.json 或 .mcp.json）中：

{
  "mcpServers": {
    "statetakehome": {
      "command": "npx",
      "args": ["-y", "statetakehome-mcp"]
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "statetakehome": {
      "command": "npx",
      "args": ["-y", "statetakehome-mcp"]
    }
  }
}

重启客户端后，即可使用以下三个工具。

工具

1. us_take_home_pay

计算美国 W-2 雇员的实得工资：联邦所得税、州所得税（全部 50 个州及 DC）、Social Security、Medicare、Additional Medicare，以及各州特有的额外税费（如 CA SDI、OR transit tax 等）。支持税前 401(k) 和健康保险扣除，并按各种发薪频率返回逐笔工资明细。

调用示例：

{
  "gross": 75000,
  "state": "CA",
  "filingStatus": "single"
}

响应（节选，来自实时引擎）：

{
  "result": {
    "gross": 75000,
    "federalTax": 7670,
    "stateTax": 2940.85,
    "socialSecurity": 4650,
    "medicare": 1087.5,
    "totalTax": 17323.35,
    "takeHome": 57676.65,
    "effectiveRate": 0.2310,
    "perPaycheck": { "biweekly": 2218.33, "monthly": 4806.39 }
  }
}

相同输入将 "state": "TX"（无州所得税）时，会返回 stateTax: 0 和 takeHome: 61592.5——相同总收入下实得金额高出 $3,915.85。

2. self_employment_tax

计算 Schedule SE 自雇税（净利润的 92.35% 按 15.3% 计税，并拆分为 Social Security 和 Medicare 两部分）、0.9% Additional Medicare 附加税、联邦所得税、可选的州所得税，以及季度预估缴税金额。

调用示例：

{
  "netProfit": 90000,
  "filingStatus": "single",
  "state": "TX"
}

响应（节选，来自实时引擎）：

{
  "result": {
    "netProfit": 90000,
    "seTax": 12716.6,
    "seTaxDeduction": 6358.3,
    "federalIncomeTax": 9571.17,
    "totalTax": 22287.77,
    "quarterlyEstimate": 5571.94,
    "setAsidePct": 0.2477
  }
}

3. capital_gains_tax

计算联邦资本利得税——长期资本利得按 0%/15%/20% 分档叠加计税，或短期资本利得按普通税率计税；还包括超过 MAGI 门槛后的 3.8% Net Investment Income Tax（NIIT），以及可选的州税估算（大多数州将资本利得作为普通收入计税）。

调用示例：

{
  "gain": 50000,
  "ordinaryTaxableIncome": 80000,
  "filingStatus": "single",
  "term": "long"
}

响应（节选，来自实时引擎）：

{
  "result": {
    "gain": 50000,
    "taxableGain": 50000,
    "federalTax": 7500,
    "niit": 0,
    "totalTax": 7500,
    "netProceeds": 42500,
    "ltcgRate": 0.15
  }
}

数据与方法

• 纳税年度： 2026 年。
• 联邦税率档和标准扣除额： IRS Rev. Proc. 2025-32。
• 州税率档和标准扣除额： Tax Foundation 的 State Individual Income Tax Rates and Brackets，截至 2026 年 1 月 1 日，并与各州税务局的数据交叉核对。
• FICA： 当前的 Social Security 工资基数和 Medicare 税率，包括 0.9% Additional Medicare 附加税。
• 资本利得： 长期资本利得税率档和 NIIT 门槛依据 Rev. Proc. 2025-32，并与 Tax Foundation 和 Schwab 的数据交叉核对。
• 每个响应都包含一个 source 区块，用于列出底层出版物；还包含一个 reference_url，指向实时网站上对应的计算器，供进一步阅读并查看方法说明：
  • https://statetakehome.com/
  • https://statetakehome.com/self-employment-tax-calculator
  • https://statetakehome.com/capital-gains-tax-calculator

此软件包中的计算代码与 statetakehome.com 使用的是同一套引擎，并通过手动方式保持同步；它并非重新实现的版本。

免责声明

此工具仅用于规划估算，不构成税务建议。每个人的税务情况各不相同；在作出财务决策前，请咨询持牌 CPA 或税务专业人士。

许可证

MIT © tresor4k