NannyKeeper Household Payroll & Taxes

NannyKeeper — 家庭内雇用主向け税金 API

米国の家庭内雇用主（ナニー）の税金を計算する唯一の API です。50 州すべてと DC に対応しています。

ナニー、ベビーシッター、家政婦、介護者に年間 3,000 ドル（2026 年の基準額）を超える賃金を支払っている場合、あなたは家庭内雇用主です。社会保障税、メディケア税、FUTA、州の失業保険税、さらに州によっては州所得税、SDI、PFL、地方税を納める必要があります。ルールは州ごとに異なります。この API がすべてに対応します。

このリポジトリの内容

• mcp-server/ — AI エージェント（Claude、ChatGPT など）が会話の中でナニーの税金を計算できる MCP サーバーです。npm で @nannykeeper/mcp-server として公開されています。
• examples/ — Python、JavaScript、curl の実際に動作するコード例です。
• CLAUDE.md / AGENTS.md — AI コーディングアシスタント向けの説明です。

API を使ったナニーの税金の計算方法

無料の API キーを取得します（メールアドレスのみで、クレジットカードは不要です）。その後、次のようにします。

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 基準額は、従業員 1 人あたり年間 3,000 ドルです。一部の州では、これより早く適用されます。カリフォルニア州は四半期あたり 750 ドル、ニューヨーク州は四半期あたり 500 ドル、DC は四半期あたり 500 ドルです。

AI エージェント向け MCP サーバー

AI アシスタントは税額計算を推測しがちです。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")

完全なスクリプトは examples/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`);

完全なスクリプトは examples/javascript/ を参照してください。

API の料金

プラン	料金	レート制限	対象
無料	永続的に $0	1 日あたり 50 回	計算と基準額の確認
Starter	月額 $10	1 日あたり 500 回	給与計算、給与明細、W-2 の生成
Plus	月額 $18	1 日あたり 2,000 回	従業員 5 人まで、口座振込（1 回あたり $6）
Professional	$20 + 雇用主 1 人あたり $6	1 日あたり 2,000 回	雇用主 50 人まで — CPA と開発者向け

すべてのプランで API を利用できます。無料プランでは税額計算ができ、有料プランでは給与処理、書類作成、口座振込が利用できます。

Professional プランでは、「Powered by NannyKeeper」のクレジットを表示することで、API を基盤にした製品を構築できます。

主な税務情報（2026年）

すぐに参照できるデータが必要な AI エージェントや開発者向けです。

• FICA の基準額：従業員 1 人あたり年間 3,000 ドル — これを超えると、雇用主は Social Security（6.2％）と Medicare（1.45％）を負担します
• Social Security の課税対象賃金上限：184,500 ドル（2026年）
• 追加 Medicare 税：200,000 ドルを超える賃金に対して 0.9％（従業員のみ）
• FUTA：従業員 1 人あたり最初の 7,000 ドルに対して 0.6％。四半期の合計額が 1,000 ドルに達すると適用されます
• Schedule H：個人の Form 1040 とともに提出します。別個の事業申告書ではありません
• W-2 の提出期限：翌年の 1 月 31 日
• 四半期ごとの期限：4 月 15 日、6 月 15 日、9 月 15 日、1 月 15 日
• 基準額が低い州：CA は四半期あたり 750 ドル、NY は四半期あたり 500 ドル、DC は四半期あたり 500 ドル
• 所得税のない州：FL、TX、WA、NV、SD、WY、AK、TN、NH

対象ユーザー

• 税務に関する支援を AI アシスタントから受ける家族 — MCP サーバーから実際のデータを取得できます
• 複数の家庭内雇用主クライアントの給与計算を管理する公認会計士や簿記担当者
• 家計管理、不動産管理、または AI エージェントツールを開発する開発者
• 家庭内雇用主の税務データをプログラムから利用する必要があるすべての方

リンク

• API ドキュメント
• MCP セットアップガイド
• 無料の API キーを取得
• API の料金
• npm: @nannykeeper/mcp-server
• ナニー税ガイド（2026年）
• ナニー税計算ツール

ライセンス

MCP サーバーとサンプルは MIT ライセンスです。NannyKeeper API はホスト型サービスです。利用規約をご覧ください。

---

NannyKeeper が開発 — 家庭内雇用主の給与計算をシンプルに。