CalcBloc tax and salary calculator

CalcBloc MCP サーバー：AI アシスタント向けの手取り額、雇用主負担額、公式税率表

calcbloc-mcp は、AI アシスタントが CalcBloc のデータを使って、手取り額、雇用主負担額、国をまたいだ給与比較を算出したり、公式の所得税表や社会保障税表を参照したりできる Model Context Protocol（MCP）サーバーです。米国（全州）、英国、カナダ、オーストラリア、インド、ドイツ、フランス、スペイン、オランダを含む41か国に対応しています。すべての回答に対象税年度が記載され、税率の根拠となる政府の公式情報源へのリンクが含まれ、「Data by CalcBloc」のクレジットが付与されます。

CalcBloc は、itmarkerz technologies の製品です。

npx -y calcbloc-mcp (npm package) でインストールできます。このサーバーは、公式の MCP Registry に io.github.itmarkerz/calcbloc-mcp として登録されています。

目次

• できること
• クイックスタート
• AI クライアントの設定
• ツール
• 呼び出し例
• 設定
• 制限とキャッシュ
• オフライン税率表
• 開発
• データ、ライセンス、クレジット

できること

アシスタントには、次のような質問ができます。

• 「カリフォルニア州で独身として申告する場合、年収85,000ドルの手取り額はいくらですか？」
• 「年収60,000ユーロの人を雇うと、ドイツの雇用主にはいくらかかりますか？」
• 「スコットランドの50,000ポンドと、ドイツの同額の給与を比較してください。」
• 「2026年のオンタリオ州所得税の税率区分と、その根拠を教えてください。」
• 「2026-27年度の英国の国民保険料の基準額はいくらですか？」

このサーバーは、読み取り専用のツールを5つ提供します。

ツール	戻り値
calculate_take_home_pay	所得税と従業員負担額を差し引いた手取り額。年額、月額、週額の内訳付き
calculate_employer_cost	給与に雇用主の社会保障負担額、給与税、その他の付随費用を加えた額
compare_countries	欧州中央銀行の参照レートで換算した、2か国における同額の給与の比較
get_tax_tables	国、年、地域別の公式税率表（税率区分、控除額、負担率、基準額）
list_countries	対応国、税年度、地域、および各計算で指定できるオプション

計算には CalcBloc の公開 API（calcbloc.com/developers）を使用します。これは calcbloc.com の計算ツールと同じ計算エンジンおよびデータを利用しています。すべての結果には、次の情報が含まれます。

• 数値が適用される 税年度；
• 使用した税率の公式情報源の URL（政府刊行物または法令上の刊行物）。各情報源の最終確認日も記載されます；
• 結果に対応する calcbloc.com のページ（計算ツールまたは税率表ページ）；
• **「Data by CalcBloc」**のクレジットと、数値は推定値であり、税務上の助言ではないことを示す短い注記。

税率表は41か国すべてで利用できます。手取り額の計算は現在、そのうち12か国（米国、英国、カナダ、オーストラリア、ニュージーランド、アイルランド、インド、ドイツ、フランス、スペイン、オランダ、シンガポール）に対応しています。それ以外の国では、ツールがその旨を伝え、該当国の税率表へのリンクを表示します。list_countries には常に最新の国一覧が表示されます。

クイックスタート

必要条件：Node.js 20 以降。

npx -y calcbloc-mcp

このサーバーは stdio 経由で MCP 通信を行うため、通常は自分で起動する必要はありません。以下のスニペットを使って AI クライアントに追加すると、必要に応じてクライアントが起動します。API キーは不要です。無料キーを使うと、1 日あたりの上限が増えます（上限とキャッシュを参照）。

リモートサーバー（インストール不要）

同じ 5 つのツールは https://calcbloc.com/mcp（Streamable HTTP、サインイン不要）でもホストされています。カスタムコネクターを使った claude.ai や Claude Desktop（設定 > コネクター > カスタムコネクターを追加）など、URL で MCP サーバーに接続するクライアント、または Claude Code で使用できます。

claude mcp add --transport http calcbloc https://calcbloc.com/mcp

キーがない場合、各アドレスには、共有の日次合計の範囲内で 1 日あたり 500 回（1 分あたり 30 回）のツール API 呼び出しが割り当てられます。ご自身の無料キー（1 日あたり 5,000 回）を使うには、X-API-Key ヘッダーとして送信します。たとえば claude mcp add --transport http calcbloc https://calcbloc.com/mcp --header "X-API-Key: your-free-key" を使用するか、Authorization: Bearer your-free-key として送信します。

AI クライアントのセットアップ

すべてのクライアントで同じコマンド npx -y calcbloc-mcp を使用します。CALCBLOC_API_KEY の設定は任意です。省略するか、calcbloc.com/developers/keys から無料キーを貼り付けてください。

Claude Desktop

設定 > 開発者 > 設定を編集を開き、claude_desktop_config.json にサーバーを追加します（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\、Linux：~/.config/Claude/）。

{
  "mcpServers": {
    "calcbloc": {
      "command": "npx",
      "args": ["-y", "calcbloc-mcp"],
      "env": {
        "CALCBLOC_API_KEY": "your-free-key"
      }
    }
  }
}

Claude Desktop を終了して再起動します。

Claude Code

claude mcp add --transport stdio calcbloc -- npx -y calcbloc-mcp

API キーを設定すると、すべてのプロジェクトで利用できます。

claude mcp add --transport stdio --scope user --env CALCBLOC_API_KEY=your-free-key calcbloc -- npx -y calcbloc-mcp

プロジェクトと共有するには、プロジェクトルートの .mcp.json に追加し、キーは環境変数に保持します。

{
  "mcpServers": {
    "calcbloc": {
      "command": "npx",
      "args": ["-y", "calcbloc-mcp"],
      "env": { "CALCBLOC_API_KEY": "${CALCBLOC_API_KEY:-}" }
    }
  }
}

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加します。

{
  "mcpServers": {
    "calcbloc": {
      "command": "npx",
      "args": ["-y", "calcbloc-mcp"],
      "env": { "CALCBLOC_API_KEY": "your-free-key" }
    }
  }
}

VS Code（GitHub Copilot）

.vscode/mcp.json に追加するか、コマンドパレットから MCP: サーバーを追加を実行します。VS Code は初回にキーを尋ね、安全に保存します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "calcbloc-api-key",
      "description": "CalcBloc API key (optional, leave empty for anonymous use)",
      "password": true
    }
  ],
  "servers": {
    "calcbloc": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "calcbloc-mcp"],
      "env": { "CALCBLOC_API_KEY": "${input:calcbloc-api-key}" }
    }
  }
}

または、キーを使わずにターミナルから実行します。

code --add-mcp '{"name":"calcbloc","type":"stdio","command":"npx","args":["-y","calcbloc-mcp"]}'

Windsurf と Devin

Devin Desktop と Devin CLI は ~/.config/devin/mcp_config.json（Windows：%APPDATA%\devin\mcp_config.json）またはプロジェクト内の .devin/mcp_config.json を読み込みます。Windsurf は MCP 設定で同じ mcpServers 形式を使用します（生の設定）。

{
  "mcpServers": {
    "calcbloc": {
      "command": "npx",
      "args": ["-y", "calcbloc-mcp"],
      "env": { "CALCBLOC_API_KEY": "your-free-key" }
    }
  }
}

OpenAI Codex（CLI、IDE 拡張機能、アプリ）

codex mcp add calcbloc -- npx -y calcbloc-mcp

または、~/.codex/config.toml に追加します。

[mcp_servers.calcbloc]
command = "npx"
args = ["-y", "calcbloc-mcp"]

[mcp_servers.calcbloc.env]
CALCBLOC_API_KEY = "your-free-key"

その他の MCP クライアント

ローカル（stdio）MCP サーバーを起動できるクライアントなら、どれでも動作します。コマンド npx に引数 -y calcbloc-mcp を指定し、必要に応じて環境変数に CALCBLOC_API_KEY を設定してください。

ツール

すべてのツールは読み取り専用かつ冪等で、出力スキーマを宣言しています。結果は読みやすいテキストと、スキーマに一致する structuredContent として返されます。

calculate_take_home_pay

引数	型	備考
country	string、必須	コードまたは国名：us、uk、canada、india、germany、"United Kingdom"...
gross_salary	number、必須	該当国の通貨での額面給与。シンガポール以外はすべて年額です（シンガポールは月額）。
region	string	地域によって計算が異なる場合に指定します：米国の州（ca）、英国の構成国（scotland）、カナダの州（on）、スペインの自治州（md）、ドイツの州（by）、インドの州（mh）。
year	string	現在の課税年度（2026 または 2026-27）がデフォルトです。それ以前の年度は税額表として利用できます。
options	object	国ごとのオプションです。例：米国 {"filing_status": "married", "children": 2}、英国 {"pension_pct": 5, "student_loan": "plan2"}、ドイツ {"tax_class": 3, "church": true}。list_countries にすべてのオプションが一覧表示されます。

利用可能な場合は、手取り年収、控除合計、実効税率、エンジンの全計算結果、年次・月次・週次の内訳、注記、および使用した入力値を返します。

calculate_employer_cost

calculate_take_home_pay と同じ引数を使用します（英国の pension_mode や米国の health_per_month など、雇用主向けのオプションも指定できます）。年間および月間の総コスト、利用可能な場合はコスト倍率、雇用主負担分の内訳を返します。

compare_countries

引数	型	説明
country_a, country_b	string、必須	計算対象となる異なる2つの国。
gross_salary	number、必須	currency で指定する通貨建ての年間総給与。
currency	string	国Aまたは国Bの通貨（ISOコード）。デフォルトは国Aの通貨です。
region_a, region_b	string	米国、英国、カナダ、インドの地域。

両国の項目（総給与、所得税、保険料、手取り額、実効税率、前提条件）、為替レートと日付、差額、平易な英語による要約を返します。

get_tax_tables

引数	型	説明
country	string、必須	41か国のいずれか。
year	string	デフォルトは最新の年です。前年のデータも利用できる国があります（例：英国の 2025-26）。
region	string	地域別の税表：米国の州、カナダの州、英国の構成国（スコットランド、ウェールズ）、スイスの州、スペインの自治州、イタリアの州など。
group	string	income-tax、employee、employer、other のいずれかのセクションのみ。
sections	string[]	指定したセクションIDのみ。

各セクションの行（開始額／終了額／税率を含む階層、または単位付きの値）、基準、注記、公式ソースに加え、税表ページ、JSON API、CSVダウンロードへのリンクを返します。非常に長い税表の場合は、まずセクション一覧を返すため、アシスタントは必要な部分を尋ねることができます。

list_countries

引数なしの場合、すべての国について、現在の税年度と利用できるツールを一覧表示します。country を指定すると、その国の地域と、許可される値やデフォルト値を含むすべての計算オプションも一覧表示します。

呼び出し例

以下は、MCP SDK クライアントから stdio 経由で記録した、サーバーの実際の応答です。数値は2026年11月11日時点の CalcBloc API のものです。長いソース一覧は短縮しています。

スコットランドでの手取り額、£50,000

{ "name": "calculate_take_home_pay", "arguments": { "country": "uk", "gross_salary": 50000, "region": "scotland" } }

Take-home pay in United Kingdom (Scotland), tax year 2026-27
Gross salary: GBP 50,000.00 (annual gross salary in GBP)
Take-home pay: GBP 38,024.07 a year
Effective deduction rate: 23.95%

Your pay in 2026/27 (Year | Month | Week, GBP):
- Gross salary: 50,000.00 | 4,166.67 | 961.54
- Income Tax: 8,982.05 | 748.50 | 172.73
- National Insurance: 2,993.88 | 249.49 | 57.57
- Take-home pay: 38,024.07 | 3,168.67 | 731.23
...
Calculator: https://calcbloc.com/uk/take-home-pay-calculator
Tax tables: https://calcbloc.com/uk/tax-tables/2026-27/scotland

Official sources:
- HMRC: Income Tax rates and allowances for current and previous tax years (updated 6 April 2026): https://www.gov.uk/government/publications/rates-and-allowances-income-tax/income-tax-rates-and-allowances-current-and-past (checked 2026-10-16)
- GOV.UK: Rates and thresholds for employers 2026 to 2027 (Class 1 National Insurance thresholds and rates): https://www.gov.uk/guidance/rates-and-thresholds-for-employers-2026-to-2027 (checked 2026-10-16)
...

Estimate for information only, not tax, legal or financial advice. Figures follow the official sources listed; check them, or ask a qualified adviser, before making decisions.
Data by CalcBloc: https://calcbloc.com/uk/take-home-pay-calculator (licence CC BY 4.0, https://calcbloc.com/data)

対応する structuredContent（短縮版）：

{
  "country": "uk",
  "countryName": "United Kingdom",
  "region": "scotland",
  "taxYear": "2026-27",
  "currency": "GBP",
  "grossSalary": 50000,
  "netAnnual": 38024.07,
  "effectiveRate": 0.2395186,
  "results": { "netMonthly": 3168.6725, "incomeTax": 8982.05, "employeeNi": 2993.88, "employerNi": 6749.4 },
  "taxTablesUrl": "https://calcbloc.com/uk/tax-tables/2026-27/scotland",
  "sources": [{ "title": "HMRC: Income Tax rates and allowances ...", "url": "https://www.gov.uk/government/publications/rates-and-allowances-income-tax/income-tax-rates-and-allowances-current-and-past", "retrievedAt": "2026-10-16" }],
  "calcblocUrl": "https://calcbloc.com/uk/take-home-pay-calculator",
  "attribution": "Data by CalcBloc",
  "licence": "CC BY 4.0",
  "disclaimer": "Estimate for information only, not tax, legal or financial advice. ..."
}

ドイツでの雇用主コスト、€60,000

{ "name": "calculate_employer_cost", "arguments": { "country": "germany", "gross_salary": 60000 } }

Employer cost in Germany, tax year 2026
Gross salary: EUR 60,000.00 (annual gross salary in EUR (above the Midijob range))
Total cost to the employer: EUR 73,392.00 a year
Monthly cost: EUR 6,116.00

Employer cost of a €60,000 salary (Berlin) (Year | Month, EUR):
- Gross salary: 60,000.00 | 5,000.00
- Pension insurance (employer half): 5,580.00 | 465.00
- Unemployment insurance (employer half): 780.00 | 65.00
- Health insurance (employer half): 5,250.00 | 437.50
- Long-term care insurance (employer half): 1,080.00 | 90.00
- U1 sick-pay levy (0.8%): 480.00 | 40.00
- U2 maternity levy (0.22%): 132.00 | 11.00
- U3 insolvency levy (0.15%): 90.00 | 7.50
- Total employer cost: 73,392.00 | 6,116.00
...
Data by CalcBloc: https://calcbloc.com/germany/germany-employer-cost-calculator (licence CC BY 4.0, https://calcbloc.com/data)

£50,000で英国とドイツを比較

{ "name": "compare_countries", "arguments": { "country_a": "uk", "country_b": "germany", "gross_salary": 50000 } }

Salary comparison: United Kingdom vs Germany, GBP 50,000.00 a year

England, United Kingdom (tax year 2026-27):
- Gross: GBP 50,000.00
- Income Tax: GBP 7,486.00
- National Insurance: GBP 2,993.88
- Take-home pay: GBP 39,520.12 (20.96% deducted)
...
Germany (tax year 2026):
- Gross: EUR 59,941.26
- Wage tax: EUR 9,372.00
...
- Take-home pay: EUR 37,532.10 (37.39% deducted)
...
Exchange rate: 1 GBP = 1.1988 EUR, rates as of 6 November 2026 (European Central Bank reference rates)
Comparison page: https://calcbloc.com/compare/salary

オンタリオ州の所得税表

{ "name": "get_tax_tables", "arguments": { "country": "canada", "region": "on", "group": "income-tax" } }

Tax tables: Canada, Ontario, tax year 2026 (in force 2026-01-01 to 2026-12-31)
Currency: CAD. Status: verified.

### Ontario income tax brackets
(section: provincial-income-tax; group: income-tax; basis: Taxable income, per year)
- 0 to 53,891 at 5.05%
- 53,891 to 107,785 at 9.15%
- 107,785 to 150,000 at 11.16%
- 150,000 to 220,000 at 12.16%
- 220,000 and above at 13.16%
Source: T4127 Payroll Deductions Formulas, 122nd Edition, effective January 1, 2026 (CRA), ..., https://www.canada.ca/content/dam/cra-arc/formspubs/pub/t4127-jan/t4127-01-26e.pdf (checked 2026-10-25)
...

まだ計算に対応していない国

{ "name": "calculate_take_home_pay", "arguments": { "country": "austria", "gross_salary": 50000 } }

Take-home pay calculation is not available for Austria yet. Its official 2026 tax tables are available: call get_tax_tables with country "austria", or see https://calcbloc.com/austria/tax-tables/2026.

設定

すべての設定は省略可能な環境変数で、クライアントの env ブロックに設定します。

変数	デフォルト	用途
CALCBLOC_API_KEY	なし	任意。1日あたり50件を超えるリクエストに必要です。calcbloc.com/developers/keys から無料のAPIキーを取得できます。すべてのリクエストで X-API-Key ヘッダーとして送信されます（1日あたり5,000件、1分あたり60件）。
CALCBLOC_DATA_DIR	なし	CalcBlocの税表データのコピーを含むフォルダー。税表はまずここから読み込まれます（オフライン税表を参照）。
CALCBLOC_API_URL	https://calcbloc.com/api/v1	APIのベースURL（テスト用）。
CALCBLOC_TIMEOUT_MS	20000	リクエストのタイムアウト時間（ミリ秒）。
CLAUDE_PLUGIN_OPTION_CALCBLOC_API_KEY	なし	CalcBloc Claudeプラグインが渡す名前で設定する、同じAPIキー（plugin/）。両方が設定されている場合は CALCBLOC_API_KEY が優先されます。空の値や ${user_config.calcbloc_api_key} のような未入力のプレースホルダーは、キーが設定されていないものとして扱われます。

制限とキャッシュ

CalcBloc API は無料です。キーなしの場合、IP アドレスごとに 1 日 50 リクエスト、1 分あたり 5 リクエストが許可されます。無料キーを使うと、1 日 5,000 リクエスト、1 分あたり 60 リクエストが許可されます。キーなしで利用できる上限に達すると（API が 429 を返すか、X-RateLimit-Remaining: 0 を報告すると）、ツールのエラーにはキーなしで利用できる無料枠を使い切ったことが示され、続けて 「無料の API キーを追加」 と表示されます。そこから calcbloc.com/developers/keys にリンクされ、このサーバーの env ブロックで CALCBLOC_API_KEY として設定し、再起動するよう案内されます。上限がリセットされるまでは、サーバーはそれ以上リクエストを送信しません（各ツール呼び出しには、同じメッセージを即座に返します）。CALCBLOC_DATA_DIR のオフライン税テーブルは引き続き利用できます。キーを使っている場合、上限に達した際のメッセージにはキーの上限と再試行できる時刻が表示されます。

リクエストを節約するため、サーバーは国の一覧と税テーブルをメモリ内に 6 時間保持します。ある国について最初に計算するときは、最大 4 件のリクエストを使用します（国の一覧、計算、および公式のソースリンクを提供する国税・地域税のテーブル）。同じ国については、以後の計算で 1 件だけ使用します。税テーブルの検索では、テーブルごとに 1 件のリクエストを使用します。ローカルデータフォルダーが設定されている場合は、リクエストを使用しません。

オフライン税テーブル

税テーブルはオープンデータ（JSON と CSV）として calcbloc.com/data でも公開されています。コピーを保存している場合は、CALCBLOC_DATA_DIR をその場所（リポジトリのルート、または manifest.json を含む tables フォルダー）に設定してください。get_tax_tables は API を使わずにフォルダーからデータを読み込むため、API に接続できない場合も引き続き利用できます。計算には常に API が必要です。

データは npm パッケージに同梱されていません。サイズが約 10 MB あり、政府による変更の公表に合わせてテーブルが更新されるため、同梱するとリリースの合間に古くなってしまうからです。

開発

git clone https://github.com/itmarkerz/calcbloc-mcp.git
cd calcbloc-mcp
npm install
npm run build
npm test

• npm test はサーバーをビルドし、ユニットテスト（HTTP をモック）と、MCP SDK クライアントを使ってローカル API モックに対し、stdio 経由で dist/index.js を起動するエンドツーエンドテストを実行します。

• npm run inspector は、ビルド済みサーバーで MCP Inspector を起動します。コマンドラインから実行するには、次のとおりです。

  npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list
  npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call --tool-name list_countries --tool-arg country=uk
  

• クライアントでローカルビルドを使うには、npx -y calcbloc-mcp を node /path/to/calcbloc-mcp/dist/index.js に置き換えます。

公式の MCP TypeScript SDK v2（@modelcontextprotocol/server 2.4）を使って構築されています。この SDK は 2026-07-28 の MCP 仕様を実装しています。Node.js 20 以降が必要です。

データ、ライセンス、クレジット

• 税データ：CalcBloc。ライセンスは CC BY 4.0 です。クレジット表記：「CalcBloc によるデータ（calcbloc.com/data）」。各数値は、横に記載された公式ソースから取得しており、最終確認日も併記しています。
• コード：MIT ライセンス。詳しくは LICENSE をご覧ください。
• 結果は情報提供のみを目的とした推定値であり、税務、法律、金融に関する助言ではありません。

リンク

• ウェブサイト：calcbloc.com
• API ドキュメント：calcbloc.com/developers
• 無料 API キー：calcbloc.com/developers/keys
• 税テーブルとダウンロード：calcbloc.com/data
• Issue：github.com/itmarkerz/calcbloc-mcp/issues

概要

CalcBlocは、インドのケーララ州にあるウェブおよびモバイルアプリ開発会社、itmarkerz technologiesが開発・保守しています。このサーバーの基盤となるデータはcalcbloc.com/dataにあり、API ドキュメントはcalcbloc.com/developersで確認できます。CalcBloc のその他のパッケージ（Python、JavaScript、PHP、R、Google Sheets、およびデータセット自体）は、itmarkerz GitHub organizationにあります。