lit-forge-mcp

元本（一括）と毎月の積立額を、月次複利で運用したときの将来価値を計算します。NISA に限らず一般の投資・定期預金シミュに使える汎用ツール。

目標金額・現在の貯蓄・想定年利・積立期間から、目標達成に必要な毎月の積立額を逆算します。「N 年後に X 円作るには月いくら積み立てればよいか」の問いに答えるツール。

個別株のアナリスト推奨レーティング（強気買い～強気売り）・目標株価（平均/高値/安値）・月別推奨内訳を取得します（Yahoo Finance）。米国株は coverage が厚く、日本株や ETF は欠損しやすい。投資助言ではなく集約値です。

**これからの**中銀高官の発言・講演予定を返すツール。ForexFactory の無料カレンダーを取得し、発言系イベント（FRB 理事・地区連銀総裁・日銀・ECB・BOE 等）だけを日付昇順で返します。米 Fed（FOMC）の発言者は当年の名簿で **role（ダラス連銀総裁等）と votingMember（投票権の有無）** を補完します。投票権ありの発言ほど政策の方向性を示唆しやすく市場インパクトが大きいため、重要度（importance）を引き上げています（議長=★★★ / 投票メンバー=★★以上）。用途: 市況サマリーで『今日の要人発言』『今週の Fed スピーカー』を尋ねられたとき。指標・金融政策会合の予定は別ツール `get_economic_events_today` を使用してください（本ツールは“発言”専用）。【利用上の注意】第三者の無料フィード（faireconomy.media の ForexFactory 週次カレンダー）に依存します。フィード単位の失敗は sources 配列に error として記載し、取得できた分は返します（部分成功）。カバー範囲は現 FF 週（月〜日）です。range="week" が週末を跨いで翌週に及ぶ日は、その週が配信対象になるまで取得できない場合があります。FF の発言予定は時刻・有無が直前に変わることがあります。返却メタは客観値のみで、市場解釈は付与しません（呼び出し側 LLM の責務）。Fed 名簿は 2026 年版（最終確認 2026-05-27）。投票権は毎年 1 月にローテーションします。

個別株または ETF の過去 N 年の配当履歴と暦年ごとの合計を取得します（Yahoo Finance）。NISA 成長投資枠で配当銘柄を検討する際の一次情報として使用。配当ゼロ銘柄は dividends が空配列で返ります。投資助言ではありません。

本日（または今週）の主要経済イベント（FOMC・日銀金融政策決定会合・米雇用統計・CPI・GDP・中国 PMI などのマクロ指標）を返します。期間イベント（ジャクソンホール会議等）は期間中の各日に today クエリでヒットします。データは lit-forge 運営者が手動キュレーションした半年分のスケジュール。中銀高官の発言・講演は別ツール `get_central_bank_speakers`（ライブ取得）を使用してください。【利用上の注意】既定 range=today は当日分のみを返すため、ユーザーの質問が『明日』『今週』『週末』『次の指標』など今日を超える時間軸を含むときは range="week" を明示すること。直前に today で取得済みでも、未来の時間軸が話題に出た時点で week で取り直す。【v0.9.0 以降】首脳会談・要人訪問・国際サミット・主要国選挙・地政学リスクの 4 サブカテゴリは `get_geopolitical_calendar`（確定スケジュール）に、進行中の地政学情勢は `get_geopolitical_pulse`（リアルタイム速報）に分離されました。地政学情報が必要なときはそれらを使用してください。本ツールの category="geopolitical" 引数は後方互換のため残されていますが、結果は空に近くなります。

**公式機関のリリースカレンダーを実取得**して、当日〜週内の経済指標発表予定を返すツール。BEA（米経済分析局）・NY 連銀・FRB・センサス局・内閣府・日銀の公式日程を並列取得し、国・期間でフィルタして返します。【get_economic_events_today との違い】`get_economic_events_today` は運営者が一次ソースで裏取りした手動キュレーション（★★★ 中心、半年 1 回更新）で、収録対象を絞っているため取りこぼす『網羅性の穴』があります。本ツールは公式カレンダーを実取得することでその穴を埋める**補完ツール**です。市況サマリーでは両方を併用してください。【現行カバー範囲（v0.20.0）】BEA（米 GDP / 個人所得・支出〔PCE〕/ 貿易収支 / 企業収益）、NY 連銀（米 製造業景気指数 Empire State）、FRB（米 鉱工業生産 G.17）、**BLS**（雇用統計・CPI・PPI — ホワイトハウス PFEI 公式スケジュール経由）、**DOL/ETA**（米 新規失業保険申請件数 — 週次・毎週木 08:30 ET）、**ForexFactory ライブ**（米 JOLTS 求人件数・製造業/サービス業 PMI 速報・ISM 製造業/非製造業・消費者信頼感〔CB/ミシガン大〕・ADP 雇用 — faireconomy 週次カレンダー XML をライブ取得。PFEI 非収録 or 従来手動のみだった指標を動的化）、**センサス局**（米 卸売在庫・小売在庫・財貿易収支の速報 — Advance Economic Indicators Report, 月次 08:30 ET。公式 List View をライブ取得し翌年分も自動反映）、内閣府（四半期別 GDP 速報）、日銀（金融政策決定会合 / 主な意見 / 短観 / 議事要旨）。総務省統計局（日 CPI）・FOMC は次サイクルで追加予定で、現時点では本ツールに含まれません。【利用上の注意】アダプタ単位の取得失敗は sources 配列に error として記録され、他アダプタの結果は返されます（部分成功）。結果は 6 時間キャッシュされます。各イベントには一次ソース URL（sourceUrl）が付きます。

**確定済み公式スケジュール専用**ツール。首脳会談・要人訪問（bilateral）、G7/G20/IMF/APEC/BRICS/NATO 等の国際サミット（summit）、主要国の国政選挙（election）、公式の地政学リスク日程（制裁発動・条約期限など、risk）の 4 サブカテゴリを返します。各イベントには market implications（為替・株・債券・コモディティへの注目点）、参加者、一次ソース URL が付与されます。データは lit-forge 運営者が一次ソース（日本政府公式・国際機関公式・民間集計）から手動キュレーション。**半年に 1 回 PR 更新の静的データ**で、確定済み公式日程のみを収録します（主観判断要件のイベントは登録しない方針）。【重要】このツールは『カレンダー』であり、**進行中の地政学リスク（紛争激化・電撃会談・突発的な制裁・封鎖シナリオなど）を取りこぼします**。今この瞬間の地政学情勢を知りたいときは別ツール `get_geopolitical_pulse` を使ってください。【利用上の注意】既定 range=week。さらに先まで見たい場合は range="month" を指定。マクロ経済イベント（CPI・FOMC・日銀会合等）は別ツール `get_economic_events_today` を使用。

**今この瞬間の地政学情勢**を返すツール。BBC World・Al Jazeera・Google News（トピック検索）の RSS を並列取得し、dedupe + 配信日時降順で記事メタデータを返します。用途: 進行中の地政学リスク（電撃首脳会談・紛争激化・制裁発動・封鎖シナリオ等）の把握。市況サマリーで『地政学イベント』を尋ねられたときは、確定済み公式日程の `get_geopolitical_calendar` と本ツールを併用してください。【ツール設計上の重要事項】返却される各記事は客観的メタデータ（タイトル・配信元・配信日時・URL・配信元の短い summary）のみで、market implications などの**主観的な解釈はツール側で付与しません**。市場への影響評価・解釈は呼び出し側 LLM の責務です。客観性の根拠: 「主要通信社が編集判断のうえ配信した記事」のメタデータを基盤とすることで、データ収録者の主観バイアスを排除しています。【利用上の注意】通信社 RSS は通常 5-30 分以内に最新ニュースが反映されます。フィード単位での失敗は sources 配列に error として記載され、他フィードの結果は返されます（部分成功）。情報源は英語フィードが中心です。日本固有の地政学情報は不足する可能性があります（v0.10 以降で日本語フィード追加検討）。

東京（9:00-15:30 JST）/ 上海（10:30-16:00 JST）/ ロンドン（17:00-25:30 JST）/ NY（22:30-29:00 JST）の現在の取引時間ステータス（open / pre-open / closed / holiday）を返します。土日は全て closed、祝日は holiday（holidayName 付）。各市場の祝日カレンダーは手動キュレーション（米英祝日・日本国民の祝日 + TSE 規程・中国の春節等の長期休場）。サマータイム移行や臨時休場は未対応の概算。

USD/JPY・EUR/JPY・GBP/JPY・AUD/JPY・EUR/USD・CHF/JPY・ドル指数・日経平均・TOPIX・NY ダウ・S&P 500・NASDAQ・VIX・NYSE FANG+・SOX・DAX・FTSE・上海総合・ハンセン・KOSPI・SENSEX・米10年/5年金利・金・原油・銅・ビットコイン・イーサリアム の主要 28 指標の現在値と前日比を Yahoo Finance から取得します。約 1 時間遅れの参考値で、投資助言ではありません。

VIX・S&P 500 前日比・米10年金利前日比・ドル指数前日比を合成した 0-100 のリスクオン/オフ・スコアを返します。50 が中立、70 以上でリスクオン優勢、30 以下でリスクオフ優勢。各成分のスコアと過去 30 営業日の推移も含みます。投資推奨ではなく俯瞰用の指標です。

28 銘柄（為替・株・金利・コモディティ・暗号資産）を指定期間のパフォーマンス降順で並べ、上位 N と下位 N を返します。1w/1m は主要 7 銘柄（USD/JPY・S&P 500・NASDAQ・NY ダウ・米10年金利・VIX・DXY）のみ対応。投資推奨ではなく数値ソートのみ。

Yahoo Finance の任意ティッカー（株・為替・指数・コモディティ・暗号資産）の現在値・前日比・スパークラインを取得します。get_market_snapshot で扱う 28 指標以外を確認したいときに使用。includeFundamentals=true で PER/PBR/配当利回り/ベータも取得（個別株向け）。投資助言ではありません。

米株セクター ETF（テクノロジー XLK / 金融 XLF / ヘルスケア XLV / 一般消費財 XLY / 生活必需品 XLP / エネルギー XLE / 資本財 XLI / 公益 XLU / 素材 XLB / 不動産 XLRE / 通信 XLC）の現在値と前日比を一括取得。米株市場のセクターローテーションを把握する情報源。

**米マクロ三大指標**（雇用統計・CPI・PPI）+ コア指数 + 失業率 + 平均時給の最新発表値と前月比・前年同月比を返すツール。BLS（米労働統計局）の Public Data API v2 を 1 リクエストで叩き、7 系列を集約して返します。API key 不要・無認証で動作（BLS 公開 API、未登録枠の 1 日 25 リクエストで運用、6 時間キャッシュ込み）。【取得系列（v0.14.0 で 4→7 系列に拡張）】雇用統計 = 非農業部門就業者数（CES0000000001、千人）/ 失業率（LNS14000000、%）/ CPI 都市部全消費者（CUUR0000SA0、index 1982-84=100）/ **コア CPI**（食料・エネルギー除く、CUUR0000SA0L1E、index）/ PPI 最終需要（WPSFD4、index 2009=100）/ **コア PPI**（食料・エネルギー除く、WPSFD49104、index）/ **平均時給**（民間部門季調済、CES0500000003、USD/hour）。【返却内容】各指標について最新月の値・前月差・前月比%・前年同月差・前年同月比% を返します。速報値（preliminary）には preliminary=true が立ち、後日確定値に更新されます。データ欠損月（政府閉鎖等で BLS が値を出せなかった月）は value=null。【関連ツール】発表予定日は別ツール `get_economic_release_pulse`（公式機関カレンダー）/ `get_economic_events_today`（手動キュレ）を参照。本ツールは『今の指標値』、それらは『次にいつ出るか』を答えます。【利用上の注意】BLS は HTML カレンダー / RSS への bot アクセスを拒否しており、本ツールが扱う『最新値』のみが自動取得可能です。投資助言ではなく情報集約。

米10年債利回り（^TNX）と米5年債利回り（^FVX）の差（イールドスプレッド）を返します。プラスは順イールド、マイナスは逆イールド。前日比 bp も含む。投資判断の参考情報。

年齢・現在の貯蓄・毎月の積立額・退職予定年齢・退職後の希望生活費・リスク許容度・受給年金から、楽観/現実/悲観 3 シナリオで将来資産と老後資金の充足度を試算。不足する場合は現実シナリオで届く必要月額も自動逆算します。

毎月の積立額・想定年利・年数から、月次複利で将来評価額・運用益・年次推移を試算します。NISA / iDeCo の単純シミュレーション用。