EarningsCalls.dev

EarningsCalls MCP Server

ウェブサイト · MCP セットアップガイド · API ドキュメント · ライセンス：MIT

AI エージェントが EarningsCalls.dev のデータセットに直接アクセスできる Model Context Protocol サーバーです。70 か国、170 以上の取引所における17,000 社以上の企業の177,000 件以上の決算説明会のトランスクリプト（2020 年から現在まで）を収録し、役職（Executive／Analyst／Operator／Attendee／Shareholder）ごとに正確にタグ付けされた1,100 万件以上の発言者セグメント、全文検索などを利用できます。

Claude（または MCP 対応クライアント）に、自然言語で決算説明会について質問できます。

「直近の決算説明会で、NVIDIA の CFO はデータセンターの成長について何と言っていましたか？」 「直近 4 四半期における Tesla の粗利益率に関する説明を比較してください。」 「2026 年第 2 四半期の決算説明会で『関税』に言及した S&P 500 企業を見つけてください。」

https://earningscalls.dev/api/v1 の公開 REST API を薄くラップした MCP サーバーです。決算説明会の終了から数分以内に、新しい通話データが追加されます。

---

必要条件

• 有料の EarningsCalls サブスクリプション（Pro、Ultra、または Enterprise）。無料のテストキーは使用できません。earningscalls.dev/#pricing でプランをお申し込みください（月額 24.99 ドルから）。
• ローカル方式のみ：Node.js 18 以降。

---

インストール

リモート方式が 2 種類（インストール不要、推奨）、ローカル方式が 1 種類あります。

オプション A — コネクター URL（推奨）

最も簡単な方法です。トークンが埋め込まれた個人用コネクター URL を使うため、管理が必要な API キーヘッダーはありません。

1. earningscalls.dev/dashboard に移動し、→ Connectors → Generate を選択します。
2. URL をコピーします。https://earningscalls.dev/u/<your-token>/mcp のような形式です。

Claude Desktop／claude.ai（ウェブ）： Settings → Connectors → Add custom connector → URL を貼り付け → Add。（ウェブでは OAuth 欄を空のままにし、同意のポップアップで確定してください。）

Claude Code（CLI）：

claude mcp add --transport http earningscalls "https://earningscalls.dev/u/<your-token>/mcp"
# add --scope user to make it available in every project

Cursor — .cursor/mcp.json：

{
  "mcpServers": {
    "earningscalls": {
      "url": "https://earningscalls.dev/u/<your-token>/mcp"
    }
  }
}

コネクター URL はそれぞれ個別に無効化できます。デバイスまたはワークスペースごとに 1 つ生成してください。

オプション B — API キーヘッダー

クライアントをホストされたエンドポイントに接続し、API キー（ect_...）を X-API-Key ヘッダー経由で渡します。

Claude Code（CLI）：

claude mcp add earningscalls --transport http https://mcp.earningscalls.dev/mcp \
  --header "X-API-Key: ect_your_key_here"

Claude Desktop／Cursor — 設定：

{
  "mcpServers": {
    "earningscalls": {
      "url": "https://mcp.earningscalls.dev/mcp",
      "headers": { "X-API-Key": "ect_your_key_here" }
    }
  }
}

オプション C — ローカル（npx 経由）

サーバーをローカルプロセスとして stdio 経由で実行します。

claude mcp add earningscalls \
  --env EARNINGSCALLS_API_KEY=ect_your_key_here \
  -- npx -y @earningscalls/mcp-server

または、クライアントの設定に追加します。

{
  "mcpServers": {
    "earningscalls": {
      "command": "npx",
      "args": ["-y", "@earningscalls/mcp-server"],
      "env": { "EARNINGSCALLS_API_KEY": "ect_your_key_here" }
    }
  }
}

---

対応範囲

決算説明会のトランスクリプト	177,000 件以上
企業	17,000 社以上
国／取引所	70／170 以上
期間	2020 年～現在（5 年以上）
発言者セグメント	1,100 万件以上（Executive／Analyst／Operator／Attendee／Shareholder）
セクター	GICS の全 11 セクター
更新頻度	決算説明会の終了から数分以内に新しい通話データを追加

---

利用可能なツール

ツール	説明
get_dataset_stats	総件数と期間を取得します。対応範囲を把握するため、最初に呼び出してください。
list_latest_calls	最新の決算説明会を取得します。セクターで絞り込むこともできます。
list_recent_transcripts	最近追加されたトランスクリプトを取得します。
list_calls_by_ticker	ティッカー（例：PLTR、AAPL）に対応するすべての通話を、新しい順に取得します。
get_latest_call_for_ticker	ティッカーに対応する最新の通話を 1 件取得します。
get_company_by_name	企業名の全体または一部から企業を検索します。
list_companies	企業を閲覧／検索します。
list_upcoming_earnings	今後 N 日以内に予定されている決算説明会を取得します。
get_earnings_call	個別の決算説明会のメタデータを取得します。
get_transcript	決算説明会の全文を取得します。形式は full、summary、または components です。
get_speaker_segments	発言者セグメントを取得します。役職（Executive／Analyst／Operator …）で絞り込めます。
search_transcripts	すべてのトランスクリプトと発言者セグメントを全文検索します。
search_within_ticker	1 つのティッカーに限定して全文検索します。
list_sectors ／ list_industries	絞り込み条件を確認します。

---

環境変数

ローカルモード（stdio）

変数	必須	デフォルト
EARNINGSCALLS_API_KEY	はい	—
EARNINGSCALLS_BASE_URL	いいえ	https://earningscalls.dev

リモートモード（HTTP）

変数	必須	デフォルト
PORT	いいえ	3000
EARNINGSCALLS_BASE_URL	いいえ	https://earningscalls.dev

リモートモードでは、接続するクライアントからセッションごとに API キーが提供されます。コネクター URL に埋め込む方法（オプション A）と、X-API-Key ヘッダーを使用する方法（オプション B）があります。

---

開発

npm install
npm run build

npm start    # local stdio mode
npm run serve # remote HTTP mode

ソースの構成：

src/
├── index.ts      # stdio entry + preflight (local mode)
├── http.ts       # Streamable HTTP entry (remote mode)
├── client.ts     # HTTP client for earningscalls.dev API
├── config.ts     # env var loading
├── messages.ts   # user-facing banners + error hints
└── tools.ts      # MCP tool definitions

---

ライセンス

MIT