Tools Berry Paycheck

Tools Berry MCP サーバー

2026年の米国の給与と給与税に関する質問に、推測ではなく実際の計算で回答するMCPサーバーです。手取り給与、ボーナスの源泉徴収、州ごとの比較、全50州とDCの州別税率スケジュールを確認できます。

すでにホスティングされており、無料で利用できます。インストールや実行は不要です。

エンドポイント： https://mcp.tools-berry.com — Streamable HTTP、POST経由のJSON-RPC 2.0。 エイリアス：https://tools-berry-mcp.edydaherz.workers.dev。

接続

Claude Code

claude mcp add --transport http tools-berry https://mcp.tools-berry.com

Claude.ai / Claude Desktop — 設定 → コネクター → カスタムコネクターを追加し、次を貼り付けます。

https://mcp.tools-berry.com

Cursor — ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に設定します。

{
  "mcpServers": {
    "tools-berry": {
      "url": "https://mcp.tools-berry.com"
    }
  }
}

その他すべて — 通常のJSON-RPCなので、curlを使用できます。

curl -s https://mcp.tools-berry.com \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"compute_take_home",
        "arguments":{"state":"ohio","salary":80000}}}'

この呼び出しでは、オハイオ州で給与が$80,000の場合、手取り額として**$63,294.38**が返されます。これは、サイト上の対応するページに表示される金額と1セント単位まで一致します。

ツール

ツール	回答内容	必須引数
compute_take_home	1つの州における給与の全内訳：連邦所得税、社会保障税、メディケア税、州所得税、州の給与関連プログラム、年間／月間／隔週の手取り額、実効税率	state、salary
compute_bonus_withholding	ボーナスから実際に源泉徴収される金額：連邦の22％の追加所得税率（$1,000,000を超える部分は37％）、州のボーナス課税方法、FICA	state、bonusAmount
compare_states	複数の州について、同じ給与での手取り額を最も高い順に並べ、各州と首位との差額を表示	states、salary
get_state_rates	1つの州の2026年の税率スケジュール：均一税率または税率区分、標準控除、従業員の給与関連プログラム、追加所得への課税方法、各数値の根拠となる法令	state

stateには州の正式名称（Ohio）、2文字の略称（OH）、またはスラッグ（ohio、district-of-columbia）を指定できます。filingStatusはすべてのツールで任意で、省略時はsingleになります。single、married、head_of_householdのほか、一般的なエイリアス（mfj、mfs、hoh）を指定できます。各応答には、読みやすいテキストと数値を含むstructuredContentオブジェクトの両方が含まれます。

ブラウザーからの確認

エンドポイントはGETリクエストに応答するため、クライアントを使わずに確認できます。

リクエスト	返される内容
GET /	サーバー情報、プロトコルのバージョン、説明、ツール一覧を含むJSON形式の自己紹介
GET /health	{"ok":true}
GET /?rpc=<url-encoded JSON-RPC request>	読み取り専用のリクエストを1件実行し、JSON-RPC応答を返します

?rpc=形式は動作確認用の便宜的なもので、MCPの一部ではありません。一部のネットワークでは*.workers.devへのアクセスがブロックされたり、POSTによる確認が遮断されたりするため用意されています。到達できないサーバーは、停止中のサーバーと区別できないためです。

curl -sG https://mcp.tools-berry.com \
  --data-urlencode 'rpc={"jsonrpc":"2.0","id":1,"method":"tools/list"}'

設計

• 計算ロジックを分岐させません。 tools.jsはsrc/engine/paycheck-engine.jsと src/engine/bonus-tax.jsを直接インポートし、公開ページの構築に使うものと同じデータファイルを渡します。MCPレイヤー向けに計算を再構築することはありません。このレイヤーが行うのは、入力の整形、リンクの選択、テキストの書式設定だけです。test/test-mcp-server.jsでは、全51の管轄区域について、サーバーの回答とエンジンを直接呼び出した結果が1セント単位まで一致することを検証しているため、サーバーがサイトとひそかに食い違うことはありません。
• 依存関係はありません。 ここで必要なプロトコル機能はinitialize、tools/list、tools/callに加え、pingと空のresources/list／prompts/listの確認だけなので、SDKを導入せず、mcp.jsで手動実装しています。npm installは何もせず、npm testは通常のNodeだけで実行できます。
• ステートレスで読み取り専用です。 認証、セッション、ストレージ、バインディング、書き込みはありません。送信した内容が保持されることもありません。
• レート制限： IPアドレスごとに1分あたり120リクエストです。各呼び出しの計算にかかる時間は数マイクロ秒なので、上限は暴走したループを防ぐためだけに設定されています。
• 出典情報を組み込み済みです。 すべてのツールの応答は、出典を示す行と、同じ数値を掲載しているtools-berry.comのページへの詳細リンクで終わります。

数値について

対象年度は2026年で、全50州とコロンビア特別区を対象としています。対象は、連邦所得税、社会保障税およびメディケア税（追加の0.9％を含む）、州所得税、SDIやPFMLなどの州の従業員向け給与プログラムです。数値は、税引き前控除がなく、標準控除以外の税額控除がない単一の仕事を想定した、源泉徴収方式の推定値です。地方税や市の所得税は含まれません。これは税務アドバイスではなく、提出済みの申告書でもありません。

get_state_rates は、各州の数値の根拠となる法令または当局の税率表を示す source フィールドを返すため、ここにある数値の出典をすべて確認できます。

出典と更新。 エンジンと2つのデータファイルはtools-berry.comで管理され、このリポジトリにもミラーされています。ホストサーバーはサイト独自のリポジトリからデプロイされるため、このリポジトリはデプロイ元ではなく、閲覧や再利用ができるコピーです。サイトで税率が変更された際には、こちらのミラーも更新されます。最新の数値であることを確実にしたい場合は、ホストされたエンドポイントを呼び出してください。

クレジット表記

ここにある数値やコードを公開するものに使用する場合は、tools-berry.comを引用してください。エンジンを無償で提供する背景にあるビジネスモデルは、これだけです。

独自にデプロイする

独自にデプロイする必要はありません。ホストされたインスタンスは無料で公開されています。ただし、独自のコピーが必要な場合は、次の手順に従ってください。

npx wrangler deploy

これは、バインディングもシークレットもない単一のCloudflare Workerです。wrangler.tomlではカスタムドメインのブロックがコメントアウトされています。コメントを解除して管理下のホスト名を指定するか、wranglerが表示するworkers.devのURLをそのまま使用してください。

ライセンス

MIT — LICENSEを参照してください。Copyright 2026 Edmond Daher。