nannykeeper (Imaznation)

保姆-家庭雇主税API

计算美国家庭雇主（保姆）税的唯一API。覆盖所有50个州+DC。

如果你付给保姆、保姆、管家或看护人的工资超过3000美元/年（2026年门槛），你就是一个家庭雇主。这意味着社会保障、医疗保险、FUTA、州失业率，以及可能的州所得税、SDI、PFL和地方税。每个州的规则都不一样。这个API处理所有这些。

这个回购中有什么

• 示例/ --Python、JavaScript和curl中的工作代码示例。
• CLAUDE.md / 代理商.md --AI编码助手说明。

如何使用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定价

所有计划都包括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服务器提供真实数据
• 注册会计师和簿记员 为多个家庭雇主客户管理工资单
• 开发者 构建家庭理财、物业管理或人工智能代理工具
• 任何人 谁需要以编程方式获取家庭雇主税务数据

链接

• API文档
• MCP设置指南
• 获取免费的API密钥
• API定价
• 保姆税务指南（2026）
• 保姆税务计算器

许可证

MCP服务器和示例是MIT许可的。NannyKeeper API是托管服务-请参阅 条款.

______________________________________________________________________

建造于 保姆 --家庭雇主的工资单变得简单。