Sec Contracts

@pipeworx/sec-contracts

SEC 提出書類から見つかった重要契約の別紙（信用契約、社債契約、合併契約、雇用契約、退職金契約）を、SEC EDGAR の全文検索ではなく、文書内の条項の文言から検索します。edgar では答えられない逆引きの質問、つまり「Adobe は何を提出したか」ではなく、「2025 年以降に提出された信用契約のうち、支配権変更条項を含むものはどれか」に答えます。

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

ツール

• sec_contracts_search(query, match?, exhibit_type?, form?, since?, until?, company?, sic?, limit?, include_snippets?) — テキストに指定した語句を含む別紙（EX-10／EX-4／EX-2、または任意の種類）を検索します。別紙文書ごとに 1 行で、企業、CIK、ティッカー、親フォーム、提出日、別紙の種類と提出者による別紙の説明、該当箇所の前後のスニペット、文書の URL とアクセッション番号を返します。さらに、同じ行を提出書類ごとにまとめて表示します。
• sec_contract_text(url | adsh + filename + cik, max_chars?, offset?, find?) — 別紙をページ分割されたプレーンテキストとして取得します。find を指定すると、語句（「支配権の変更」の定義、「解約手数料」など）の最初の出現箇所に移動します。
• sec_contracts_by_company(company, exhibit_type?, form?, since?, until?, limit?) — ティッカー、名称、または CIK を指定して、提出者の重要契約を新しい順に表示します。

認証

キーは不要です。SEC はすべてのリクエストに説明的な User-Agent を指定するよう求めており、このパックではそれを送信します。

データソース

• https://efts.sec.gov/LATEST/search-index — EDGAR の全文検索です。2001 年以降の各提出書類に含まれるすべての文書をインデックス化します。各検索結果には file_type（EX-10.1、EX-4.2、10-K など）、file_description、adsh、ciks、sics、display_names が含まれます。
• https://www.sec.gov/Archives/edgar/data/{cik}/{accession}/{file} — 添付書類そのものです。

後から調べ直すことにならないように記しておきます（すべて 2026-08-28 に測定）：

• efts には添付書類の種類を指定するパラメーターがありません。 forms=EX-10 は結果を返しません。forms はルートのフォームを絞り込みます。添付書類の絞り込みは file_type を使ってクライアント側で行い、1 ページあたり 100 件（呼び出しごとに最大 500 件）を多めに取得します。申請者の入力ミスで EX-103 が存在するため、プレフィックス判定には EX-10(?!\d) を使います。
• ハイライトはありません。 検索レスポンスにスニペットは含まれません。スニペットは、一致した添付書類ごとに先頭 1.5 MB を読み込み、語句が最初に出現する箇所を中心に抜き出して生成します。処理は一度に 5 件です。
• 片側だけの dateRange=custom は無視されます。 enddt を指定せず startdt だけを指定すると、フィルターが空になり、2008 年の結果が返されます。必ず両端を指定します。
• 引用符で囲まれていない単語は AND で結合されます（それぞれ 1 つの match_phrase 条件）。語句間の OR は機能し、二重引用符で囲んだフレーズは完全一致します。q=* は何も一致しません。そのため、企業別ツールでは ciks フィルターと併せて、契約関連語（agreement OR indenture OR amendment …）を幅広く OR で結合して検索します。
• アーカイブ URL には登録者の CIK が必要で、アクセッション番号のプレフィックスではありません。 提出代行業者のアクセッション番号（0001193125-… = Donnelley）では、代行業者 CIK のパスは 503 を返します。このため、検索結果には解決済みの cik と document_url が含まれます。
• efts のレスポンスキャッシュは sics／ciks／entityName をまたいで漏れます。 エンドポイントの手前にある API Gateway キャッシュのキーに含まれるのは、q、日付範囲、forms、from／page であり、sics、ciks、entityName は含まれません。2026-08-28 に測定したところ、sics=7372 を指定したリクエストが、数秒前に同じ q と日付でキャッシュされた未フィルターの 10,000 件の結果を返しました。逆方向の漏れ（ソフトウェア関連のみの結果が未フィルターのリクエストに返されるケース）も確認されています。本文のエコーされた query を見ると、実際に適用されたフィルターがわかります。このパックでは、これらのフィルターのいずれかが指定されたときに、q に否定形の無意味なトークン（-zqfs7372）を追加します。efts はこれを何にも一致しない must_not にコンパイルし（合計件数が同一であることを確認済み）、キャッシュキーをフィルターの組み合わせごとに一意にします。また、すべての行で sic／cik を再確認し、除外されたものがあれば note で報告します。efts に ciks／sics を渡す他のパックも、同じ漏れの影響を受けます。
• 対象期間の下限は 2001-01-01 です。それ以前の since はこの日付に補正され、レスポンスに記載されます。

クイックスタート

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

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

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

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

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/sec_contracts_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"change of control","exhibit_type":"EX-10","since":"2025-01-01","limit":12}'

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

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

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイを経由した通信も不要です。

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

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

npx -y @pipeworx/mcp-sec-contracts

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

ask_pipeworx を使う

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

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

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

もっと詳しく

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

ライセンス

MIT