Sec Beneficial Ownership

@pipeworx/sec-beneficial-ownership

SEC Schedule 13D／13Gの実質的所有者に関する届出です。公開企業の株式を5％以上保有するのは誰か、どのような権限を持つか（単独または共同の議決権／処分権）、そして13Dの場合はその理由（Item 4「取引の目的」に示されるアクティビスト投資家のシグナル）を確認できます。 SECが2024年の規則以降に求めている構造化XMLを解析し、それ以前のプレーンテキストの届出については何も返さずに済ませるのではなく、正直に structured: false として処理します。

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

ツール

• sec_13d_filings(ticker_or_cik, form_type?, limit?) — 発行体のSchedule 13D／13Gの届出（および修正届出）を新しい順に一覧表示します。各行には、構造化XMLか2024年以前のプレーンテキストかが示されます。
• sec_13d_filing(ticker_or_cik, accession_number) — 1件の届出を解析します。各報告所有者について、クラスに対する保有割合、単独／共同の議決権、単独／共同の処分権、保有株式総数を取得できます。13Dの場合は、Item 4の目的に関するテキストも取得できます。規則以前の届出は、範囲を制限したプレーンテキストにフォールバックします。
• sec_13d_amendment_diff(ticker_or_cik, accession_number) — 13D/Aまたは13G/Aを指定すると、同じ報告グループの一連の届出から直前の届出を探し、保有割合、所有者ごとの議決権／処分権、および（13Dの場合）Item 4の目的に関するテキストが変更されたかどうかを比較します。

認証

認証キーは不要です。SEC EDGARは無料で公開されており、APIキーは必要ありません。必要なのは説明的な User-Agent のみで、このパックはSECの開発者向けガイドラインに従い、すべてのリクエストにこれを送信します。

データソース

• https://data.sec.gov/submissions/CIK##########.json — 発行体ごとの届出インデックス（様式の種類、アクセッション番号、届出日、主要文書名）。mcps/edgar と共通のパターンです。
• https://www.sec.gov/Archives/edgar/data/{cik}/{accession}/primary_doc.xml — SECの2024年の構造化データ規則以降の届出（様式の種類が SCHEDULE 13D／SCHEDULE 13G）に含まれる、構造化XMLです。
• https://www.sec.gov/Archives/edgar/data/{cik}/{accession}/{primary_document} — 規則以前の届出（様式の種類が SC 13D／SC 13G）に含まれる、プレーンHTML／テキスト文書です。
• https://www.sec.gov/files/company_tickers.json — 共有の resolveSecEntity ヘルパーを使用して、ティッカー／会社名からCIKを解決します（mcps/edgar でも使用）。SECをキーとするすべてのパックで共通のリゾルバーを使い、ここで別の実装を用意する必要はありません。

知っておくべき注意点

• 構造化された提出書類では、提出書類インデックスの primaryDocument フィールドは生の文書ではなく、ビューアーのパスです。 xslSCHEDULE_13D_X01/primary_doc.xml のような形式ですが、この URL をそのまま取得すると、機械可読な XML ではなく、ブラウザー向けにサーバー側で XSLT 変換された HTML が返されます。ファイル名が .xml で終わっていても同じです。実際の構造化 XML は、どの XSLT スタイルシートのバリエーション（X01、X02、…）がビューアーのパスに指定されているかにかかわらず、アクセッションのアーカイブのルート直下、1 つ上のディレクトリにある primary_doc.xml です。このパックでは、構造化された提出書類は常にルートのパスから取得します。mcps/sec-form-d も Form D で同じ規則に従います。
• SC 13D／SC 13G（規則改定前のプレーンテキスト）と SCHEDULE 13D／SCHEDULE 13G（規則改定後の構造化 XML）は、同じフォームの異なる時代のものです。 SEC の 2024 年の構造化データ規則では、文書形式だけでなく、提出タイプの文字列も変更されました。このパックのフィルタリングロジックでは、両方を 1 つのファミリー（13D／13G）に正規化するため、フォームタイプでフィルタリングする呼び出し元はすべての時代の提出書類を取得できます。
• previousAccessionNumber（存在する場合）は、直前の修正ではなく、修正の連鎖における元の提出書類を指します。 実データで確認したところ、同じ報告グループによる連続 3 回の修正すべてで、同一の previousAccessionNumber（2024 年の元の提出書類）が使われていました。また、これは常に存在するわけではありません。後の XSD 改訂版（X0202。少なくとも 1 つの大手機関投資家による提出書類で確認）では完全に省略されています。sec_13d_amendment_diff は、これを「直前の提出書類」への直接のポインターとしてではなく、報告所有者の同一性の重なりと並ぶ、連鎖への所属を示すシグナルの 1 つとして扱います。
• 13D/A または 13G/A に再記載されるのは、変更された項目だけです。 修正書類の items1To7（13D）または items（13G）ブロックでは、前回の提出書類から内容に変更がない場合、その項目の内容は単に省略されることがあります。たとえば item2 や item4 などが省略されても、解析に失敗したわけではありません。SEC のスキーマでは、このように修正書類を提出できます。sec_13d_filing と sec_13d_amendment_diff は、不在の項目に対して内容を捏造せず、null を返します。
• Schedule 13G に「目的」フィールドはありません。 13D の Item 4 は「取引の目的」（自由記述）ですが、13G の Item 4 は「所有権」（金額／割合／議決権）であり、すでに reporting_owners で扱われています。item4_purpose が値を持つのは 13D の場合のみです。13G の場合は null となり、その理由を説明する note が付与されます。
• SEC への送信は、すべての SEC／EDGAR パックでフリート全体に共有されます（送信元 IP は 1 つです）。 ここにあるすべてのツールは、範囲を限定した特定の提出書類セットを読み取ります。発行体の履歴を一括でクロールすることはありません。sec_13d_amendment_diff が前の提出書類を探すために行う遡及スキャンには上限があり、取得する提出書類は最大 6 件です（MAX_CHAIN_SCAN = 6）。

クイックスタート

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/sec_13d_filings \
  -H 'Content-Type: application/json' \
  -d '{"ticker_or_cik":"IMXI","form_type":"all","limit":10}'

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

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

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

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

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

npx -y @pipeworx/mcp-sec-beneficial-ownership

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

ask_pipeworx を使用する

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

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

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

詳細

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

ライセンス

MIT