Irs Afr

@pipeworx/irs-afr

毎月のIRS歳入決定から、任意の月のIRS適用連邦金利（短期・中期・長期、すべての複利期間、110／120／130％の各バリエーション、調整後AFR）と第7520条金利を取得します。

Pipeworx の一部です。AI エージェントを1858以上の稼働中のデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流のプロバイダーとは提携、承認、公開のいずれもしていません。

ツール

• irs_afr(month?, term?, compounding?, percent?) — ある月のAFR表を取得します。短期（最長3年）、中期（3年超9年以下）、長期（9年超）について、年次、半年次、四半期次、月次の複利計算における金利と、110％、120％、130％の各バリエーション（中期は150％、175％も含む）、調整後AFRを返します。フィルターを指定すると、単一の金利を返します。「2026年11月の中期AFRは、年次複利でいくらですか？」といった質問に回答します。
• irs_7520_rate(month?) — 年金、終身不動産権、年限不動産権、残余権、復帰権の評価に用いる第7520条金利に加え、同じ歳入決定に記載された第382条の長期非課税金利と低所得者向け住宅税額控除率を取得します。

最新の公表月を取得するには、month を省略してください。IRSは各月の金利を前月（通常は月半ば）に公表するため、翌月分の金利は通常、15日頃から入手できます。まだ公表されていない月を指定すると、空の結果ではなく、予想される公表時期を含む status: "not_yet_published" が返ります。

すべてのレスポンスには、ruling（例：「Rev. Rul. 2026-21」）、data_as_of（IRSが歳入決定を公表した日付）、source が含まれます。

認証

キーは不要です。

データソース

• IRS、適用連邦金利に関する歳入決定 — AFR、調整後AFR、第382条、低所得者向け住宅税額控除、ならびに第7520条の金利を定める、内国歳入庁の月次歳入決定です。米国連邦政府の著作物であり、パブリックドメインです。リクエストごとに歳入決定をライブで読み込み、複製データは保存しません。

メンテナー向けの注記：歳入決定番号は月順ではありません（月は歳入決定本文から読み取ります）。また、IRSの一覧ページは最新の歳入決定の反映が遅く、月の表示も誤っているため、参考情報としてのみ使用し、後続の番号を直接照会します。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "irs-afr": {
      "url": "https://gateway.pipeworx.io/irs-afr/mcp"
    }
  }
}

このエンドポイントが実際に提供する内容

https://gateway.pipeworx.io/irs-afr/mcp の tools/list は、上の表のツールに加えて、共有Pipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールに加えて、共有ツールがおよそ30個表示されます。接続の initialize レスポンスには正確な対象範囲が記載され、その日の情報として最も信頼できるものです。

これは意図的なもので、誤って多重化されているわけではありません。メタツールを使えば、対象を絞った接続からでも、このパックの対象外の質問に ask_pipeworx 経由で回答できます。これはカタログ全体に問い合わせるため、2つ目のMCPサーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマがもたらすコンテキストコストに対して、ルーティングのメリットが見合わない場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworxのフルゲートウェイに接続すれば、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1858以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCPクライアントがない場合は、HTTP経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/irs_afr \
  -H 'Content-Type: application/json' \
  -d '{"month":"2026-11","term":"mid","compounding":"annual","percent":100}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/irs_afr を使用します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

npm から実行

@pipeworx/mcp-irs-afr は Pipeworx ゲートウェイへのローカル stdio ブリッジです。MCP クライアントが npx で起動し、上記と同じ https://gateway.pipeworx.io/irs-afr/mcp エンドポイントにすべての呼び出しを転送します。ネットワークアクセスが必要です。オフラインモードはありません。

{
  "mcpServers": {
    "irs-afr": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-irs-afr"]
    }
  }
}

キーがない場合は匿名で呼び出し、1 日あたり 50 回に制限されます。無料アカウントを作成すると、1 日あたり 200 回まで利用できます。https://pipeworx.io/signup でキーを取得し、サーバーエントリに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。 キーはホスト接続と同じ方法で Bearer トークンとして送信されるため、呼び出しはそこでの利用と同様に計測され、課金されます。

デフォルトでは、このパックのツールのみを一覧表示します。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx やその他のゲートウェイ全体のツールも一覧表示されます。

HTTPS プロキシ経由の場合、Node の組み込み fetch はデフォルトで HTTPS_PROXY を読み取りません。新しい Node リリースでは NODE_USE_ENV_PROXY=1 を設定すると有効になります。使用している Node のバージョンのドキュメントを確認してください。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、平易な英語で質問できます。この方法は、上記のパックのエンドポイントでも、ゲートウェイ全体でも利用できます。

ask_pipeworx({ question: "your question about Irs Afr data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT