Sec Ftd

@pipeworx/sec-ftd

SEC のフェイル・トゥ・デリバー（CNS）データ。キー不要です。

Pipeworx の一部です。AI エージェントを 1683 以上の稼働中データソースに接続する MCP ゲートウェイです。

ツール

• ftd_security(symbol, periods?) — 1 つのティッカーについて、直近の半月分ファイルにわたるフェイルの履歴を取得します。
• ftd_largest(period?, limit?) — 1 つの報告期間で、フェイル数が最も多いものを取得します。
• ftd_periods() — SEC が公開している期間を確認します（現在は 408 期間、2009 年まで遡ります）。

このパックでは意味合いが重要です

フェイル・トゥ・デリバーとは決済失敗です。決済日までに株式が引き渡されなかったことを意味します。SEC は、このファイルを公開する場合、フェイルは裸の空売りの証拠ではないと述べています。一般的な原因には、処理の遅延、注文入力ミス、流動性の低い証券の流動性不足、売り手の株式が間に合わなかった現物売りなどがあります。

逆の推論を望む声が大きいことから、この説明は脚注にとどまりません。すべてのツールの説明に含まれ、すべてのレスポンスにも what_this_is と not_evidence_of として付与されます。ペイロードだけを読むエージェントであっても、裸の空売りという結論を正当に導き出すことはできません。

レスポンス自体で示される、もう 2 つの読み取り上の注意点があります。

• **公開される数値は累積値であり、日ごとの新規分ではありません。**その決済日に、すべての参加者で決済に失敗した株式数の合計です。日ごとの数値を合計すると、失敗が続いている分を重複して数えることになります。そのため ftd_security は合計とあわせて peak_shares_failed を返し、その旨を reading_note で説明します。また ftd_largest は合計ではなく、各証券の単日での最大値に基づいて順位付けします。
• **データがないからといって、問題がないとは限りません。**SEC は、フェイルが報告基準値を超えた日付に限り証券を掲載します。そのため「行がない」とは、報告対象となるフェイルがないことを意味するだけで、フェイルがまったくなかったことや、ティッカーが不明であることを意味しません。found: false の場合は、その旨を明示します。

データソースと更新頻度

https://www.sec.gov/data-research/sec-markets-data/fails-deliver-data — 半月ごとに 1 ファイル（a = 1〜15 日、b = 16 日〜月末）のパイプ区切りファイルが ZIP 形式で公開されます。2026-08-25 時点の測定では、現在のファイル（cnsfails202607b.zip）は ZIP 圧縮後 1.65 MB、展開後 4.6 MB、73,340 行で、13,500 の証券を網羅しています。SEC は各期間の終了から数週間後に公開します。

各呼び出しでは、質問に必要な期間を SEC から直接読み込むため、データの新しさは SEC が公開した内容に準じます。公開済みの期間は ftd_periods で確認できます。多数の期間をまたぐリクエストでは半月ごとに 1 回取得するため、periods の上限は 6 です。

知っておきたい上流データの注意点が 2 つあります

• **ファイルのパスは組み立てられません。**直近のファイルは /files/data/fails-deliver-data/ にあり、それより古いファイルは /files/data/other/fails-deliver-data/ にあります。2026-08-25 の検証では、cnsfails202605b.zip は最初のパスでは 404、2 つ目のパスでは 200 でした。このパックは推測でパスを組み立てるのではなく、SEC のインデックスページを読み取ります。
• **これらの ZIP ではデータ記述子フラグ（0x08）が設定されているため、ローカルファイルヘッダーのサイズは両方ともゼロです。**ローカルファイルヘッダーを信頼するリーダーでは何も展開できません。サイズは、常に実際の値が記録されている中央ディレクトリから取得します。

クイックスタート

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

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

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

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

これは意図的な設計であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックでは対応できない質問にも、ask_pipeworx でカタログ全体を横断して回答できるため、MCP サーバーを追加する必要がありません。現在、メタツールなしでパックのエンドポイントに接続する方法はありません。追加のスキーマによるコンテキストのコストが、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、ゲートウェイ全体に一度だけ接続してください。

または、Pipeworx ゲートウェイ全体に接続すると、このパックだけでなく、すべてのパックのツールが直接表示されます。

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

どちらの URL も、同じゲートウェイと同じ1,683以上のデータソースにつながります。違いは、どのパックのツールが直接表示されるかだけです。どちらからでも、ask_pipeworx ですべてのツールを利用できます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ftd_security \
  -H 'Content-Type: application/json' \
  -d '{"symbol":"GME","periods":2}'

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

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

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

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

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

npx -y @pipeworx/mcp-sec-ftd

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Sec Ftd data" })

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

詳細

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

ライセンス

MIT