保姆-家庭雇主税API
计算美国家庭雇主（保姆）税的唯一API。覆盖所有50个州+DC。
如果你付给保姆、保姆、管家或看护人的工资超过3000美元/年（2026年门槛），你就是一个家庭雇主。这意味着社会保障、医疗保险、FUTA、州失业率，以及可能的州所得税、SDI、PFL和地方税。每个州的规则都不一样。这个API处理所有这些。
这个回购中有什么
如何使用API计算保姆税
在获取免费API密钥（仅限电子邮件，无信用卡） nannykeeper.com/developers/keys那么：
curl -X POST https://www.nannykeeper.com/api/v1/calculate \
-H "Authorization: Bearer nk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"state":"CA","annual_wages":35000,"pay_frequency":"biweekly"}'返回雇主税（社会保障、医疗保险、FUTA、州失业率）、员工税估算、每笔工资成本和门槛状态——所有这些都来自为每个州维护的当年税务数据。
先检查阈值
不确定你是否需要纳税？阈值端点告诉您：
curl -H "Authorization: Bearer nk_live_YOUR_KEY" \
"https://www.nannykeeper.com/api/v1/threshold?state=CA&annual_wages=2500"2026年，联邦FICA门槛为每位员工每年3000美元。一些州的触发时间更早：加利福尼亚州为750美元/季度，纽约州为500美元/季度。
用于AI代理的MCP服务器
人工智能助手猜测税务计算。使用NannyKeeper MCP服务器，他们可以从当年的数据中获得确切的数字。
{
"mcpServers": {
"nannykeeper": {
"command": "npx",
"args": ["@nannykeeper/mcp-server"],
"env": { "NANNYKEEPER_API_KEY": "nk_live_YOUR_KEY" }
}
}
}将此添加到您的Claude Desktop配置中，重新启动并询问保姆税。Claude调用API，并给出具体的逐行分解，而不是粗略估计。
可用工具：
calculate_nanny_taxes--美国任何州的完整联邦+州税明细check_threshold--工资是否引发家庭雇主义务preview_payroll--模拟工资计算（无数据库写入）run_payroll--使用年初至今跟踪和数据库持久性端到端运行工资单（需要Starter+）。从v1.5.0开始，直接存款工资单pay_date超过5个工作日退货status: scheduled并自动开火scheduled_send_at，所以pay_date意思就是它所说的。
完整设置指南： nannykeeper.com/developers/mcp
代码示例
python
import requests
response = requests.post(
"https://www.nannykeeper.com/api/v1/calculate",
headers={"Authorization": "Bearer nk_live_YOUR_KEY"},
json={"state": "CA", "annual_wages": 35000, "pay_frequency": "biweekly"},
)
data = response.json()["data"]
print(f"Employer taxes: ${data['employer_taxes']['total']:,.2f}/year")看 示例/python/ 完整的剧本。
JavaScript
const response = await fetch("https://www.nannykeeper.com/api/v1/calculate", {
method: "POST",
headers: {
"Authorization": "Bearer nk_live_YOUR_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ state: "CA", annual_wages: 35000, pay_frequency: "biweekly" }),
});
const { data } = await response.json();
console.log(`Employer taxes: $${data.employer_taxes.total}/year`);看 示例/javascript/ 完整的剧本。
API定价
| 计划 | 价格 | 费率限制 | 适用 |
|---|---|---|---|
| 免费 | 永久0美元 | 每天50美元 | 计算+阈值检查 |
| 新手 | 每月10美元 | 每天500美元 | 全额工资、工资单、W-2代 |
| 加 | 18美元/月 | 2000美元/天 | 最多5名员工，直接存款（6美元/转账） |
| 专业 | 20美元+6美元/雇主 | 2000美元/天 | 最多50个雇主-适用于注册会计师和开发人员 |
所有计划都包括API访问。免费级别包括税务计算；付费计划增加了工资处理、文档生成和直接存款。
专业级别允许在API之上构建具有“由NannyKeeper提供动力”属性的产品。
关键税务事实（2026年）
对于需要快速参考数据的AI代理和开发人员：
- FICA门槛：每位员工每年3000美元——高于此水平，雇主欠社会保障（6.2%）+医疗保险（1.45%）
- 社会保障工资基数: $184,500 (2026)
- 额外医疗保险税：工资超过20万美元时为0.9%（仅限员工）
- 福塔每位员工前7000美元的0.6%；触发价格为每季度1000美元
- 附表H：与个人1040表格一起提交，而不是单独的商业申报表
- W-2截止日期：次年1月31日
- 季度截止日期：4月15日，6月15日9月15日1月15日
- 门槛较低的州：加利福尼亚州750美元/季度，纽约州500美元/季度
- 无所得税的州：FL、TX、WA、NV、SD、WY、AK、TN、NH
谁用这个
- 家庭 其人工智能助手帮助税务——MCP服务器提供真实数据
- 注册会计师和簿记员 为多个家庭雇主客户管理工资单
- 开发者 构建家庭理财、物业管理或人工智能代理工具
- 任何人 谁需要以编程方式获取家庭雇主税务数据
链接
许可证
MCP服务器和示例是MIT许可的。NannyKeeper API是托管服务-请参阅 条款.
______________________________________________________________________
建造于 保姆 --家庭雇主的工资单变得简单。