edgaralert

EDGAR Alert MCP サーバー

Claude Desktop（または任意の MCP 対応クライアント）を、EDGAR Alert アカウントに直接接続します。会話を離れることなく、SEC のインサイダー取引シグナル、Form 4 の動向、8-K の役員・取締役の変更、企業調査のコンテキストについて、最新情報を尋ねることができます。

EDGAR Alert の有料プランで利用できます。 最新アラート、検索、企業プロフィール、ファンダメンタルズ、株価期間など、ほとんどのツールは STARTER と PRO で利用できます。AI 調査コンテキストをまとめて提供する edgaralert_get_company_agent_context のみ Enterprise が必要です。下位プランでは、黙って失敗する代わりに、わかりやすいアップグレード案内を返します。詳しくは下記のツールをご覧ください。アップグレードは edgaralert.com/pricing から行えます。

これは何か（何ではないか）

• 既存の公開 REST API https://api.edgaralert.com/api/v1 を利用する薄いラッパーです。各ツールは、v1 エンドポイントのいずれか1つだけに対応します。
• データベースに直接アクセスしません。 スコアリングやシグナルのロジックを重複して実装していません。これらはすべて API 側にあり、他のすべての v1 API 利用者と同様です。
• 請求、アカウント管理、取引は行いません。 このサーバーから注文を出したり、サブスクリプションを変更したり、アカウント設定を変更したりすることはできません。
• 書き込みを行うツールは2つだけで、対象はご自身のウォッチリストに限られます。 edgaralert_add_ticker_to_list と edgaralert_remove_ticker_from_list は /ticker-lists に対して POST と DELETE を行います。それ以外はすべて GET です。
• API キーはお客様ご自身のものです。お客様が指定し、X-API-Key ヘッダーとして api.edgaralert.com にのみ送信されます。このサーバーがキーをディスクに書き込んだり、ログに記録したりすることはありません。

必要条件

• Node.js 18.17 以降
• 有料プランの EDGAR Alert API キー （こちらから取得）— STARTER と PRO ではほとんどのツールを利用できます。Enterprise では8つすべてを利用できます。

インストール

オプション A：.mcpb によるワンクリックインストール（ほとんどのユーザーにおすすめ）

1. 最新リリースから edgaralert-mcp.mcpb をダウンロードします。
2. Claude Desktop を開き、Settings → Extensions → Advanced settings → Install Extension を選択して、ダウンロードしたファイルを指定します（または、ファイルを Claude Desktop のウィンドウにドラッグします）。
3. 入力を求められたら、EDGAR Alert API キーを貼り付けます。Claude Desktop はキーを OS のキーチェーンに安全に保存します。このプロジェクトがキーを確認または保存するのは、この入力時のみです。
4. 指示があった場合は、Claude Desktop を再起動します。

オプション B：claude_desktop_config.json による手動インストール

1. このフォルダー（mcp-server/）を、マシン上の任意の場所にクローンまたはダウンロードします。

2. 依存関係をインストールしてビルドします。

   cd mcp-server
   npm install
   npm run build
   

3. Claude Desktop の設定ファイルを開きます。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

4. mcpServers の下にエントリーを追加します（以下の例を参照）。

5. Claude Desktop を再起動します。

オプション C：開発用にローカルで実行

cd mcp-server
npm install
EDGARALERT_API_KEY=EA_your_key_here npm run dev

ビルド手順を経ずに、tsx を使用して stdio 上でサーバーを実行します。ツール定義を反復的に調整する際に便利です。

Claude Desktop 設定の例

{
  "mcpServers": {
    "edgaralert": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "EDGARALERT_API_KEY": "EA_your_key_here"
      }
    }
  }
}

/absolute/path/to/mcp-server/dist/index.js をお使いのマシン上の実際のパスに、EA_your_key_here を実際の EDGAR Alert API キーに置き換えてください。実際のキーを含むこのファイルをコミットしないでください。

環境変数

変数	必須	デフォルト値	説明
EDGARALERT_API_KEY	はい	—	EDGAR Alert v1 の API キーです。すべてのリクエストで X-API-Key として送信されます。
EDGARALERT_BASE_URL	いいえ	https://api.edgaralert.com/api/v1	ステージング／ローカル開発用の上書き設定です。ほとんどのユーザーは設定する必要はありません。

ツール

12 個のツールのうち 10 個は読み取り専用です。ウォッチリストを変更する 2 つのツールは、以下で 書き込み とマークされています。入力スキーマ、エンドポイントの対応関係、エラー時の動作の詳細は、docs/tools.md を参照してください。

ツール	エンドポイント	最小プラン
edgaralert_get_latest_alerts	GET /alerts/latest	STARTER
edgaralert_search_alerts	GET /alerts	PRO
edgaralert_get_alert_price_window	GET /alerts/{id}/price-window	PRO
edgaralert_search_companies	GET /companies/search	PRO
edgaralert_get_company_profile	GET /companies/{tickerOrCik}/profile	有料プランすべて
edgaralert_get_company_fundamentals	GET /companies/{tickerOrCik}/fundamentals	PRO
edgaralert_get_company_agent_context	GET /companies/{tickerOrCik}/agent-context	ENTERPRISE
edgaralert_get_weekly_insights	GET /insights/weekly (公開)	なし
edgaralert_get_industry_capital_flow	GET /insights/capital-flow (公開)	なし
edgaralert_get_ticker_lists	GET /ticker-lists	STARTER
edgaralert_add_ticker_to_list	POST /ticker-lists/{listId}/items (書き込み)	STARTER
edgaralert_remove_ticker_from_list	DELETE /ticker-lists/{listId}/items/{ticker} (書き込み)	STARTER

「最小プラン」は、現在、基盤となる API が適用している要件を示しています。STARTER および PRO のキーでは、12 個のツールのうち 11 個を使用できます。Enterprise が必要なのは edgaralert_get_company_agent_context のみです。それより低いプランのキーでは、黙って失敗したりクラッシュしたりせず、アップグレードを促すメッセージとともに明示的な 403 を返します（下記参照）。2 つの /insights/* ツールは公開されており、プランは不要です。

表示される可能性のあるエラー

• 「Your EDGAR Alert API key was rejected」 — EDGARALERT_API_KEY が設定され、値が正しいことを確認してください。
• 「This action requires a higher EDGAR Alert plan」 — STARTER/PRO キーで edgaralert_get_company_agent_context を実行した場合に想定されるエラーです。それ以外のツールは、これらのプランで通常どおり動作します。別のツールでこのエラーが表示された場合は、EDGAR Alert ダッシュボードでプランの種類を再確認してください。
• 「rate or daily quota exceeded」 — プランの API 利用制限に達しています。時間を置くか、EDGAR Alert ダッシュボードで使用状況を確認してください。
• 「Could not reach the EDGAR Alert API」 — アカウントではなく、ネットワークまたは接続の問題です。node -e "fetch('https://api.edgaralert.com/api/v1/alerts/latest').then(r=>r.text()).then(console.log)" を実行してください。{"message":"Missing X-API-Key header."} のような JSON エラーが表示されるはずです（これは想定どおりで、API に到達できていることを意味します）。DNS エラー（ENOTFOUND／ENODATA）が発生する場合や応答がない場合は、このサーバーやアカウントではなく、ローカルのネットワークまたは DNS に問題があります。
• 「Unexpected token '<', is not valid JSON」 — リクエストはサーバーに到達しましたが、API データの代わりに HTML ページが返されました。EDGARALERT_BASE_URL が api.edgaralert.com ではなく、edgaralert.com または www.edgaralert.com に設定されている場合に発生します。ドメイン直下のホストと www ホストは、API ではなくマーケティングサイト（Azure Static Web App）を提供しています。このパッケージではデフォルトで api.edgaralert.com が設定されています。このエラーが表示された場合は、設定のどこかで EDGARALERT_BASE_URL が上書きされていないか確認してください。

セキュリティに関する注意事項

• このサーバーには、管理、請求、注文管理に関する機能は一切ありません。設計上、これらのエンドポイントは実装されていません。
• このパッケージには、シークレットがハードコードされている箇所はありません。使用する認証情報は、環境変数または Claude Desktop の設定を通じて指定するものだけです。
• ツールの呼び出し間で、データがキャッシュされたりディスクに保存されたりすることはありません。
• ネットワークアクセスは EDGARALERT_BASE_URL（デフォルトは api.edgaralert.com）に限定されており、その他の外部呼び出しは行われません。

開発

npm run typecheck   # type-check without emitting
npm run build        # compile to dist/
npm run dev           # run with tsx, no build step

新しいツールを追加するには、入力なしのツールの場合は src/tools/getWeeklyInsights.ts、フィルターを使うツールの場合は src/tools/searchAlerts.ts のパターンをコピーし、src/tools/index.ts に登録してください。また、呼び出すのは api/v1/* またはすでに公開されているその他のエンドポイントに限ってください。このパッケージにデータベースクライアント、Stripe／注文クライアント、書き込み可能なツールを追加しないでください。