platformtaxhub-mcp

README.md

platformtaxhub-mcp

Platform Income Utils の無料のプラットフォーム収入計算ツール3つを、MCP 対応 AI エージェントが直接呼び出せるツールとして提供する MCP サーバーです。

3つのツールはすべて、公開中のウェブページとまったく同じ計算方法を使用するため、エージェントの回答が platformincome.com で人が見る内容と食い違うことはありません。

ツール

take_home_pay_calculator

18のギグ／クリエイター／フリーランス／eコマースプラットフォームを対象に、プラットフォーム手数料、任意の約2％の通貨換算コスト、および任意の出金ごとの取引手数料を差し引いた手取り額を計算します。 take-home-pay.html に対応しています。

list_take_home_platforms

take_home_pay_calculator が受け付けるすべてのプラットフォームの ID、名前、手数料体系を一覧表示します。

platform_payout_calendar

1つ以上のプラットフォームについて、次回の支払い開始予定日と銀行への入金日（支払日＋地域ごとの振込所要日数。週末の場合は翌営業日に繰り越し）を返します。 platform-payout-calendar.html と同じデータソースから最新データを取得するため、新たに追加されたプラットフォームや修正されたスケジュールは、サーバーの再デプロイなしで自動的に反映されます。

list_payout_platforms

platform_payout_calendar が受け付けるすべてのプラットフォームの ID、名前、確認ステータスを一覧表示します（同じデータソースから最新情報を取得します）。

benefits_safety_net_calculator

雇用主の福利厚生がないギグワーカー、フリーランサー、クリエイター、販売者、ホスト向けに、毎月自分で積み立てる健康保険料と退職後の資金（デフォルトは5％を60／40に分割）の金額を計算し、任意で緊急時用の予備資金も計算します。 benefits-safety-net.html に対応しています。

list_benefits_countries

benefits_safety_net_calculator が受け付けるすべての国を通貨とともに一覧表示します。

currency_takehome_calculator

このツールならではの機能です。複数のプラットフォームからそれぞれ異なる通貨で得た収入をまとめ、ライブ為替レートを使用して、ユーザーの国で最も多くの金額を受け取れる国際口座プロバイダー（Wise、Payoneer、Airwallex など）を通じて、換算後の合計額を算出します。無料の手取り額計算ツールの多くは、一度に扱えるプラットフォームも通貨も1つだけです。このツールは、「5つのプラットフォームから3種類の通貨で収入を得ている場合、実際に手元に残る金額はいくらか」という疑問に答えるために作られています。 currency-takehome.html に対応しています。

list_currency_takehome_countries

currency_takehome_calculator が受け付けるすべての国コードを一覧表示します。

list_platformtaxhub_tools

platformincome.com にある、無料の計算ツールをすべて一覧表示します。ここで個別の MCP ツールとして提供していないもの（走行距離控除、納税期限カレンダー、手数料比較など）も含まれます。これにより、上記のツールで対応できない質問でも、エージェントが適切な無料ツールをユーザーに案内できます。

インストールと実行

npx platformtaxhub-mcp

または、MCP クライアントの設定に追加します（Claude Desktop、Claude Code など）。

{
  "mcpServers": {
    "platformtaxhub": {
      "command": "npx",
      "args": ["-y", "platformtaxhub-mcp"]
    }
  }
}

API キーもアカウントも不要です。ここにあるすべてのツールは無料で、platformincome.com の無料ツールと同じです。

開発

npm install
npm run build
npm start

src/data.ts には、プラットフォーム手数料の表と国／通貨の表が含まれています。これらは take-home-pay.html と benefits-safety-net.html の対応する <select> オプションおよび JS オブジェクトから、そのまま移植したものです。公開中のサイトで変更があった場合は、それに合わせて data.ts を更新してください。platform_payout_calendar には管理が必要な静的な表はなく、カレンダーページと同じ n8n webhook から常に最新データを取得します。

ライセンス

MIT — 計算ツールそのものについては、このパッケージがラップする platformincome.com の無料ツールを参照してください。このパッケージはそれらの MCP インターフェースのみを提供します。