mcpField
T
Toolstem Sec MCO Server

Toolstem Sec MCO Server

ローカル
github.com/toolstem金融データ118 週間前に更新

Toolstem Sec MCO Server について

SEC EDGAR の公開提出データから構造化された開示シグナルを計算し、企業の提出書類、インサイダー提出、アクティビスト活動、重要イベントを分析するエージェント向けサーバーです。ホスト型エンドポイントのほか、セルフホストにも対応します。

主な機能

  1. 01企業提出書類と傾向の要約
  2. 02インサイダー提出状況の確認
  3. 0313D のアクティビスト活動を検出
  4. 048-K イベントを重要度別に整理
  5. 052~5 社の開示シグナルを比較

活用シーン

  1. 01企業の提出状況や開示傾向の調査
  2. 02インサイダー提出と 13D 活動の確認
  3. 03指定期間の重要イベントの整理
  4. 04複数企業の開示シグナルの比較

MCP 対応

SEC EDGAR を調べる 5 つの整理済みツールを MCP クライアントに公開し、構造化 JSON を返します。ホスト型エンドポイント、またはセルフホストの stdio・HTTP サーバーを利用でき、ホスト型のツール呼び出しは USDC による従量課金です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"toolstem-sec": {
"command": "npx",
"args": [
"-y",
"toolstem-sec-mcp-server"
],
"env": {
"SEC_USER_AGENT_CONTACT": "<SEC_USER_AGENT_CONTACT>"
}
}
}
}
起動コマンドnpx -y toolstem-sec-mcp-server
設定が必要な環境変数
SEC_USER_AGENT_CONTACTContact email embedded in the SEC EDGAR User-Agent (required by SEC fair-access policy). Defaults to [email protected].

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmtoolstem-sec-mcp-server0.1.9

ツール

5

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
ticker_or_cikstringはいティッカーシンボル(例:"AAPL")または数値の CIK(例:"320193" または "0000320193")。

詳細

SEC EDGAR MCP サーバー — インサイダーシグナル、13D アクティビストリスク、開示情報インテリジェンス

npm バージョン npm ダウンロード数 ライセンス:MIT

AI エージェント向けの SEC EDGAR インテリジェンスです。 SEC EDGAR の公開提出 API から高価値シグナルを事前計算して構造化 JSON で返す、5 つの複合ツールを提供します。

SEC API キーは不要です。 データは SEC EDGAR の公開提出 API から直接取得します。組み込みのスライディングウィンドウ型レートリミッターが、SEC の公平なアクセス上限である 10 rps を自動的に下回るよう、トラフィックを制御します。


クイックスタート — ホスト型エンドポイント(推奨)

MCP クライアントまたはエージェントをホスト型エンドポイントに接続します。API キーもインフラもセットアップも不要です。 料金は x402 を通じた呼び出しごとの課金で、エージェントのウォレットから Base メインネット上の USDC で直接支払います。

https://mcp.toolstem.com/mcp/sec
  • SEC API キー、登録、マーケットプレイスアカウントは不要です — エージェントのウォレットから直接支払います。
  • インフラは不要です — インストール、ホスト、継続稼働させるものはありません。
  • セットアップは不要です — MCP クライアントを接続してツールを呼び出すだけです。
  • initialize と tools/list は無料です(検出とスキーマのイントロスペクション)。
  • tools/call はツールごとの段階制料金です(下記の料金を参照)。
Claude Desktop

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "toolstem-sec": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.toolstem.com/mcp/sec"
      ]
    }
  }
}

Claude Desktop を再起動し、次のように尋ねます。「TSLA は過去 90 日間に重要な 8-K イベントを開示しましたか?」

任意の MCP クライアント(LangChain.js)

公式の @langchain/mcp-adapters ライブラリを使って、ホスト型 URL に直接接続できます。

import { MultiServerMCPClient } from "@langchain/mcp-adapters";
import { ChatOpenAI } from "@langchain/openai";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const client = new MultiServerMCPClient({
  toolstem_sec: {
    transport: "http",
    url: "https://mcp.toolstem.com/mcp/sec",
    // Add your x402-signing middleware via headers, OR run an x402
    // proxy locally and point url at it. See https://www.x402.org/clients.
  },
});

const tools = await client.getTools();
const agent = createReactAgent({ llm: new ChatOpenAI({ model: "gpt-4o-mini" }), tools });
await agent.invoke({ messages: "Has TSLA disclosed any material 8-K events in the last 90 days?" });
LangChain クイックスタート(langchain-toolstem)

langchain-toolstem ラッパーが x402 の支払いを処理するため、資金を用意したウォレットキーを渡すだけで SEC ツールが自動的に含まれます。

import { createToolstemTools } from 'langchain-toolstem';
const tools = await createToolstemTools({ walletPrivateKey: process.env.WALLET_KEY });
// SEC tools included automatically — agents pay per call in USDC

stdio/HTTP 経由でサーバーを自分で実行したい場合は、ページ下部の上級者向け:セルフホストを参照してください。

Toolstem プレイグラウンドでツールをお試しください。


料金

  • MCP の initialize と tools/list は無料です — 料金を支払わずにサーバーと利用可能なツールを確認できます。
  • tools/call はツールごとの段階制料金で、x402 経由で Base メインネット上の USDC で支払います。API キー、登録、マーケットプレイスアカウントは不要です — エージェントは自身のウォレットから直接支払います。
ティア呼び出しごとの料金ツール
低価格$0.005get_company_filings_summary
標準$0.05get_insider_signal、get_institutional_signal
プレミアム$0.50get_material_events_digest、compare_disclosure_signals

ツールごとの内訳:

ツールティア呼び出しごとの料金
get_company_filings_summary標準$0.005 USDC
get_insider_signal標準$0.05 USDC
get_institutional_signal標準$0.05 USDC
get_material_events_digestプレミアム$0.50 USDC
compare_disclosure_signalsプレミアム$0.50 USDC
課金の仕組み

Toolstem は x402 決済プロトコルを使用します。エージェントは API キー、サブスクリプション、請求書なしで、Base 上の USDC により呼び出しごとに支払います。エージェントのウォレットが EIP-3009 を通じて、各呼び出しの決済を自動的に行います。

最新の料金は toolstem.com/sec/ の料金ページをご覧ください。

5つのツール

5つのツールはすべて複合型/キュレーション済みです(派生シグナルを計算するか、複数の EDGAR エンドポイントから情報を集約します。生データをそのまま返すものはありません)。アノテーション:readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: true。

#ツール必須入力任意入力(デフォルト)ティア(価格/呼び出し)
1get_company_filings_summaryticker_or_cik(string)—低価格($0.005)
2get_insider_signalticker_or_cik(string)lookback_days(int 1~730、デフォルト 90)標準($0.05)
3get_institutional_signalticker_or_cik(string)quarters_back(int 1~20、デフォルト 4)標準($0.05)
4get_material_events_digestticker_or_cik(string)lookback_days(int 1~1825、デフォルト 365)プレミアム($0.50)
5compare_disclosure_signalstickers_or_ciks(string[2..5])—プレミアム($0.50)

1. get_company_filings_summary

企業の提出書類の概要:直近 20 件の提出書類と算出済みシグナルです。

シグナル説明
filing_velocity過去 365 日の平均と比較した ACCELERATING / NORMAL / SLOWING
material_event_count_90d直近 90 日間の 8-K 提出件数
disclosure_volume_trend10-K のサイズ比較に基づく RISING / STABLE / FALLING
latest_form_types直近 90 日間に提出された一意のフォームタイプ

出力例(抜粋):

{
  "ticker": "AAPL",
  "cik": "0000320193",
  "company_name": "Apple Inc.",
  "signals": {
    "filing_velocity": "NORMAL",
    "material_event_count_90d": 4,
    "disclosure_volume_trend": "RISING",
    "latest_form_types": ["8-K", "4", "DEF 14A"]
  },
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

2. get_insider_signal

設定可能な遡及期間内における Form 3 / 4 / 4/A のインサイダー提出書類の状況を調べます。必須:ticker_or_cik。任意:lookback_days(1~730、デフォルト 90)。

返される値:recent_insider_filings[](アクセッション番号と SEC URL)、net_transaction_count、buy_count、sell_count、insider_signal。

v0.1 の制限 — 件数のみ。 v0.1 で返されるのは件数と Form 4 の参照情報のみです。売買方向を考慮したシグナルは v0.2 で提供予定です(Form 4 の XML 解析)。現時点では、期間内に提出書類がある場合(方向不明)、insider_signal は null となり、インサイダー提出書類がない場合(不在を確認済み)は "NEUTRAL" となります。v0.1 では buy_count / sell_count は 0 です。

出力例(抜粋):

{
  "ticker": "MSFT",
  "cik": "0000789019",
  "company_name": "MICROSOFT CORP",
  "lookback_days": 90,
  "insider_signal": null,
  "net_transaction_count": 0,
  "buy_count": 0,
  "sell_count": 0,
  "recent_insider_filings": [
    {
      "accession_number": "0001127602-26-001234",
      "filing_date": "2026-04-15",
      "sec_url": "https://www.sec.gov/Archives/edgar/data/789019/000112760226001234/0001127602-26-001234-index.htm"
    }
  ],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

3. get_institutional_signal

SC 13D / 13D/A 提出書類から、アクティビスト投資家の活動を調べます。必須:ticker_or_cik。任意:quarters_back(1~20、デフォルト 4 ≈ 1 年)。

フィールド説明
activist_risk_flag直近 365 日間に SC 13D または 13D/A が提出されていれば true
recent_13d_filingsフォームタイプ、日付、SEC URL を含む 13D 提出書類のリスト

v0.1 の制限 — アクティビストフラグのみ。 v0.1 では、**ライブの activist_risk_flag(13D/13D-A に基づく)**と 13D 提出書類のリストを提供します。institutional_signal(ACCUMULATING / HOLDING / DISTRIBUTING)と recent_13f_count を生成する四半期ごとの 13F XBRL 解析は、v0.2 で提供予定です。現時点では、これら 2 つのフィールドは null / 0 です。

出力例(抜粋):

{
  "ticker": "NVDA",
  "cik": "0001045810",
  "company_name": "NVIDIA CORP",
  "quarters_back": 4,
  "institutional_signal": null,
  "recent_13f_count": 0,
  "activist_risk_flag": false,
  "recent_13d_filings": [],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

4. get_material_events_digest ⚡ プレミアムティア

プレミアムティア — Base メインネット上で、x402 による決済で 1 回あたり $0.50 USDC。現在の料金は、toolstem.com/sec/ のライブ料金ページをご覧ください。

設定可能な遡及期間内のすべての 8-K および 8-K/A 提出書類を、重大度順にまとめます。各項目コードは、平易な英語のラベルと重大度評価に対応付けられています。必須:ticker_or_cik。任意:lookback_days(1~1825、デフォルト 365)。

重大度例
🔴 REDサイバーセキュリティインシデント(1.05)、財務諸表の修正再表示(4.02)、破産(1.03)、上場廃止(3.01)
🟡 YELLOW買収(2.01)、新規債務(2.03)、役員の退任(5.02)
🟢 GREEN決算発表(2.02)、Reg FD(7.01)、株主投票(5.07)

返される値:events[](新しい順にソート)、redflag_count、category_counts。

出力例(抜粋):

{
  "ticker": "TSLA",
  "cik": "0001318605",
  "company_name": "Tesla, Inc.",
  "lookback_days": 180,
  "redflag_count": 1,
  "category_counts": { "RED": 1, "YELLOW": 3, "GREEN": 7 },
  "events": [
    {
      "accession_number": "0001628280-26-005678",
      "filing_date": "2026-04-10",
      "form": "8-K",
      "items": [
        { "code": "4.02", "label": "Non-Reliance on Previously Issued Financial Statements", "category": "financial", "severity": "RED" }
      ],
      "sec_url": "https://www.sec.gov/Archives/edgar/data/1318605/000162828026005678/0001628280-26-005678-index.htm"
    }
  ],
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

5. compare_disclosure_signals

主要な開示シグナルをすべて対象に、2~5社を並べて比較します。必須項目:tickers_or_ciks(string[2..5])。すべての検索は並列で実行されます。

企業ごとに返される項目:filing_velocity、material_event_count_90d、redflag_count_365d、activist_risk_flag、last_filing_date。

勝者として返される項目(ティッカーではなくCIKです。companies[]配列と照合してください):quietest_disclosure、most_active、most_redflags、activist_targets。

出力例(抜粋):

{
  "companies": [
    {
      "ticker": "AAPL",
      "cik": "0000320193",
      "filing_velocity": "NORMAL",
      "material_event_count_90d": 4,
      "redflag_count_365d": 0,
      "activist_risk_flag": false,
      "last_filing_date": "2026-04-25"
    },
    {
      "ticker": "MSFT",
      "cik": "0000789019",
      "filing_velocity": "ACCELERATING",
      "material_event_count_90d": 7,
      "redflag_count_365d": 0,
      "activist_risk_flag": false,
      "last_filing_date": "2026-04-26"
    }
  ],
  "winners": {
    "quietest_disclosure": "0000320193",
    "most_active": "0000789019",
    "most_redflags": null,
    "activist_targets": []
  },
  "meta": { "source": "sec_edgar_direct", "data_delay": "live" }
}

上級者向け:セルフホスト

ほとんどのユーザーには、上記のホスト型エンドポイントの使用をおすすめします。API キーもインフラストラクチャもセットアップも不要です。このセクションは、サーバーを自分で実行したいユーザー向けです。セルフホストする場合、プロセスの実行と、EDGAR のフェアアクセス連絡先(SEC_USER_AGENT_CONTACT)の提供はユーザーの責任です。

Claude Desktop(stdio 経由のセルフホスト)

ローカルで stdio 経由で実行します。x402 の料金は発生しません。EDGAR のフェアアクセス連絡先はご自身で用意してください。

{
  "mcpServers": {
    "toolstem-sec": {
      "command": "npx",
      "args": ["-y", "toolstem-sec-mcp-server"],
      "env": {
        "SEC_USER_AGENT_CONTACT": "[email protected]"
      }
    }
  }
}
npm(MCP stdio トランスポート)
npm install -g toolstem-sec-mcp-server
toolstem-sec-mcp-server
セルフホスト型 HTTP

3 つのモードがあります。

ローカルのみ(デフォルト — 最も安全):

toolstem-sec-mcp-server --http
# Binds 127.0.0.1:3000 — reachable only from this machine

認証ありでリモート接続:

ALLOW_REMOTE=1 MCP_AUTH_TOKEN=my-secret toolstem-sec-mcp-server --http
# Binds 0.0.0.0:3000 — requires Bearer token on every /mcp request

認証なしでリモート接続(自己責任で使用してください):

ALLOW_REMOTE=1 MCP_AUTH_DISABLED=1 toolstem-sec-mcp-server --http
# Binds 0.0.0.0:3000 — no authentication
変数説明
PORTHTTP ポート(デフォルトは 3000)
ALLOW_REMOTE127.0.0.1 の代わりに 0.0.0.0 にバインドするには、1 に設定します
MCP_AUTH_TOKEN/mcp ルート用のベアラートークン(ALLOW_REMOTE=1 の場合は必須)
MCP_AUTH_DISABLEDALLOW_REMOTE=1 の場合でも認証を省略するには、1 に設定します(非推奨)
SEC_USER_AGENT_CONTACTSEC EDGAR の User-Agent ヘッダーに含める連絡先メールアドレス

SEC EDGAR のフェアアクセスポリシー

すべての送信トラフィックは、共有のスライディングウィンドウ型レートリミッターを経由します(目標は 8 rps、SEC の 10 rps の上限を下回る安全マージンは 4 rps です)。すべてのリクエストには、パッケージを識別する User-Agent ヘッダーと、SEC のポリシーに準拠した連絡先メールアドレスが含まれます。連絡先メールアドレスは、次の方法で変更できます。

[email protected] toolstem-sec-mcp-server

SEC のフェアアクセスポリシーに違反すると、IP アドレスがブロックされる可能性があります。このサーバーは、自動的にポリシーに準拠するよう設計されています。


v0.2 のロードマップ

  • Form 4 XML 解析 — 純増株式数と、売買の方向を考慮したインサイダーシグナル(STRONG_BUYING / BUYING / NEUTRAL / SELLING / STRONG_SELLING)
  • 13F XBRL 解析 — 機関数と、四半期ごとの機関投資フローシグナル(ACCUMULATING / HOLDING / DISTRIBUTING)
  • 8-K テキスト抽出 — 各重要イベントについて、提出書類の主要な HTML ドキュメントから自然言語による要約を生成

ライセンスと作者

MIT ライセンス — LICENSEを参照してください。

Toolstemが開発しました。データはSEC EDGARから直接取得しています。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。