Finra Fixed Income

@pipeworx/finra-fixed-income

FINRA 債券市場 MCP — 米国債券市場の集計データ：米国債の取引量、社債および政府機関債市場の広がりとセンチメント、証券化商品の価格と取引状況、上限付き取引量の時系列データを提供します。プラットフォームキー（無料の FINRA Public 認証情報）を使用します。BYO にも対応しています。

Pipeworx の一部です。AI エージェントを 1879 以上の稼働中データソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認も公開もされていません。

ツール

• finra_fixed_income_datasets() — 21 個のデータセットキー、各時系列データの測定対象、フィルターに使用する日付フィールドを一覧表示します。キーは不要です。
• finra_fixed_income_series({ dataset, start_date?, end_date?, limit? }) — 時系列データを取得します。日付範囲を指定しない場合は、FINRA が直近に公開した期間のデータを返します。start_date／end_date を指定すると、その期間のデータを返します。 Treasury データセットでは、product_category（例：「Nominal Coupons」）および benchmark（例：「On-the-run」）による行フィルターも指定できます。その場合、カテゴリとベンチマークごとに集計した取引量を totals_across_returned_rows で返します。

対象範囲

市場統計の集計データのみです。 このパックは個別の債券取引を返しません。TRACE の取引テープは別の FINRA 製品で、以下の利用規約 §8 により対象外となっています。 FINRA Rule 7730 に基づいて価格が設定され、報告には 6〜18 か月の遅延が義務付けられています。このパックでは利用できず、リクエストしても提供されません。

料金 — ライセンスに基づき、料金は発生しません

すべてのプランで、各呼び出しの料金は0 クレジットであり、利用量に応じた料金区分の計算にも含まれません。これはキャンペーンでも料金設定上の判断でもありません。 FINRA の Specific Terms for Fixed Income Data §2.3(b) では、「Fixed Income Data に追加料金または増分料金を課さない」場合に限り、再配布が認められています。そのため、このパックに料金を設定するとライセンス違反になります。このパックでは meter: { credits: 0 } を設定し、ゲートウェイのパックエントリーでも zeroRated: true を設定しています。pricing-v2 では、0 クレジットの呼び出しでも基準リクエストとして扱われ、顧客の月間料金区分が進むことで、次の呼び出しの料金が変わるため、両方の設定が必要です。

同じ条項のその他 2 つの条件も、レスポンスと公開済みの利用規約で満たしています。出典の明記（すべてのレスポンスに、所有者およびデータソースとして FINRA を記載する attribution フィールドを含めます）と、呼び出し側によるさらなる再配布の禁止（https://pipeworx.io/terms §6）です。呼び出し側はこのデータを非商用の個人利用または業務利用に使用できますが、再配布はできません。

認証

ゲートウェイのプラットフォームキー（PLATFORM_FINRA_KEY）を使用するか、BYO を利用します。

OAuth2 の client_credentials を使用します。キーは "<clientId>:<clientSecret>" です。Client ID と Client Secret をコロンでつないだ形式で、epo-ops と euipo でも同じ形式を使用しています。 https://developer.finra.org で取得できる無料の Individual / Public 認証情報では、https://developer.finra.org/fees に記載のとおり、Fixed Income グループ全体を月額 0 ドルで利用できます。

有効化に関する注意

FINRA の認証情報は、有効化するまで使用できません。登録すると FINRA Gateway UserID が発行されます。API Console で API Terms of Service に同意し、メールで届くリンクからシークレットを設定する必要があります。このリンクは24 時間で期限切れになります（Client ID は別のメールで届きます）。有効化されていない認証情報を使うと、トークン交換時に 401 エラーが返されます。これは登録が未完了というより、パスワードが間違っているように見えます。

登録手続きは人間が操作する Web フローです。developer.finra.org/create-account は JavaScript のボット対策機能の背後にあり、HTTP ではアクセスできません。

既知の制約

treasuryWeeklyAggregates は公開されていません。名前は解決され、データセットのフィールドメタデータも公開されていますが、当方の認証情報では、試したすべての期間で行数がゼロになります。これには、FINRA のドキュメント自体が使用例としている 2021-01 から 2021-03 の範囲も含まれます。決して回答を返せないキーを掲載するのではなく、ソースに注記を添えて除外しています。日次および月次の財務省集計はどちらも動作します。

注意点

• トークンホストは ews.finra.org ではなく ews.fip.finra.org です。 後者は認証情報のセルフサービスホストで、トークンのパスに対して、ホストが単に間違っていることを示すものが何もないまま、HTTP 500 と空の本文を返します。
• データセット名はカタログページから導き出せません。 https://developer.finra.org/catalog のアンカースラッグ（corporate_debt_market_sentiment）は、どのようなルールでも API 名に変換できません。実際の名前は corporateMarketSentiment で、「Debt」は省かれています。同様に、「Securitized Products Trading Activity」は securitizedProductTradingActivity（「Product」は単数形）、「Corporate And Agency Capped Volume」は corporatesAndAgenciesCappedVolume（どちらも複数形）です。実際の名前は https://developer.finra.org/docs のリクエスト例に記載されています。間違った名前を指定すると、データセット名を含む 404 が返るため、タイプミスではなくデータセットが存在しないように見えます。
• グループ一覧はありません。 GET /data/group/FixedIncomeMarket と GET /metadata/group/FixedIncomeMarket はどちらも 404 です。ただし、GET /metadata/group/FixedIncomeMarket/name/<dataset> は認証情報不要で、名前の照会に使えます。404 はそのデータセットが存在しないこと、200 は存在してフィールドメタデータを公開していること、400 は存在するもののメタデータを公開していないことを意味します。
• データセットごとに日付フィールドが異なります — tradeDate、tradeReportDate、reportDate、beginningOfWeekDate、beginningOfTheMonthDate が使われており、共通のフィールドはありません。間違ったフィールドで絞り込むと、明確な 400（「The following fields are not available in this dataset」）になります。このパックの DATASETS マップの各エントリーには、それぞれのフィールドが設定されています。finra_fixed_income_datasets はこれを date_field として報告します。
• FINRA のデフォルトの行順は昇順で、sortFields では回避できません。 プラットフォームでは、すべてのパーティションフィールドに対して型が EQUAL の compareFilters エントリーも指定したリクエストに限り、sortFields を使用できます。これらのデータセットではパーティションフィールド自体が日付なので、「新しい順」はソートでは指定できません。何も指定しないと、「社債市場の取引状況はどうなっていますか」というツールの回答に 2023 年の行が含まれ、それで完全に成功したように見えてしまいます。このパックでは、認証情報を使って GET /partitions/group/FixedIncomeMarket/name/<ds> を読み取り、最新のパーティション値を取得して、EQUAL フィルターでクエリを固定します。プライシングデータセット（TBA、ARM／ハイブリッド、指定プール、CMO、CMBS、CBO／CDO／CLO、証券化商品の取引活動）はメタデータもパーティションも公開していないため、固定する対象がありません。そのため、直近 180 日間にフォールバックします。これで現在の行に到達できます。order フィールドには、呼び出しが実際に取った 3 つの経路のうちどれかが記録されます。どれも機能せず、実際に最も古い行が返された場合も含まれます。
• 返すデータがないデータセットは、[] ではなく、完全に空の本文とともに 200 を返します。 これを JSON として解析すると「Unexpected end of JSON input」が発生し、「行がない」のではなく、こちらのバグのように見えてしまいます。フィルターなしのリクエストで treasuryWeeklyAggregates がまさにこの応答を返します。
• これらの時系列データは報告の遅れを伴って公開されるため、非常に直近の期間を指定すると、誤りではなく実際にデータが空の場合があります。

データソース

• トークン：https://ews.fip.finra.org/fip/rest/ews/oauth2/access_token
• データ：https://api.finra.org/data/group/FixedIncomeMarket/name/<dataset>
• メタデータ（キー不要）：https://api.finra.org/metadata/group/FixedIncomeMarket/name/<dataset>
• パーティション（認証情報が必要）：https://api.finra.org/partitions/group/FixedIncomeMarket/name/<dataset>
• カタログ：https://developer.finra.org/catalog
• ライセンス：https://developer.finra.org/specific-terms-fixed-income-data

クイックスタート

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

{
  "mcpServers": {
    "finra-fixed-income": {
      "url": "https://gateway.pipeworx.io/finra-fixed-income/mcp"
    }
  }
}

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

https://gateway.pipeworx.io/finra-fixed-income/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 も同じゲートウェイと、同じ 1879+ のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使えばすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/finra_fixed_income_datasets \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/finra_fixed_income_datasets を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても動作します。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です：

{
  "mcpServers": {
    "finra-fixed-income": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-finra-fixed-income"]
    }
  }
}

または、直接実行して起動を確認できます：

npx -y @pipeworx/mcp-finra-fixed-income

stdin/stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Finra Fixed Income data" })

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

詳細

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

ライセンス

MIT