EarningsCalls.dev

EarningsCalls MCP 服务

网站 · MCP 设置指南 · API 文档 · 许可证：MIT

Model Context Protocol 服务，让 AI Agent 直接访问 EarningsCalls.dev 数据集——涵盖 70 个国家和 170 多个交易所、来自 17,000 多家公司的 177,000 多份财报电话会议文字记录（从 2020 年至今），包含 1,100 多万个发言者片段，并按角色清晰标注（高管／分析师／接线员／与会者／股东），还支持全文搜索等功能。

用自然语言询问 Claude（或任何支持 MCP 的客户端）有关任何财报电话会议的问题：

“NVIDIA 的 CFO 在最近一次电话会议中对数据中心增长有何看法？” “比较 Tesla 最近四个季度对毛利率的讨论。” “查找在 2026 年第二季度电话会议中提到‘关税’的 S&P 500 公司。”

这是围绕 https://earningscalls.dev/api/v1 公共 REST API 构建的轻量 MCP 封装。电话会议结束后几分钟内即可获取新会议内容。

---

要求

• 付费 EarningsCalls 订阅（Pro、Ultra 或 Enterprise）。免费测试密钥在此处无法使用——请前往 earningscalls.dev/#pricing 选择套餐（每月 24.99 美元起）。
• 仅本地方式需要：Node.js 18+。

---

安装

提供两种远程方式（无需安装，推荐）和一种本地方式。

选项 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（命令行）：

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 都可单独撤销——请为每台设备或每个工作区生成一个。

选项 B — API 密钥请求头

将客户端指向托管端点，并通过 X-API-Key 请求头传入 API 密钥（ect_...）。

Claude Code（命令行）：

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）

通过标准输入／输出将服务作为本地进程运行。

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 多万个（高管／分析师／接线员／与会者／股东）
行业板块	全部 11 个 GICS 行业板块
更新速度	电话会议结束后几分钟内即可获取新会议内容

---

可用工具

工具	说明
get_dataset_stats	总数和日期范围——先调用以了解数据覆盖范围。
list_latest_calls	最新电话会议，可按行业板块筛选。
list_recent_transcripts	最近新增的文字记录。
list_calls_by_ticker	某个股票代码（例如 PLTR、AAPL）的所有电话会议，按时间从新到旧排序。
get_latest_call_for_ticker	某个股票代码最近一次电话会议。
get_company_by_name	按公司全名或部分名称查找公司。
list_companies	浏览／搜索公司。
list_upcoming_earnings	未来 N 天内已安排的电话会议。
get_earnings_call	单次电话会议的元数据。
get_transcript	一次电话会议的全文——格式为 full、summary 或 components。
get_speaker_segments	发言者片段，可按角色筛选（高管／分析师／接线员……）。
search_transcripts	对所有文字记录和发言者片段进行全文搜索。
search_within_ticker	在某个股票代码范围内进行全文搜索。
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