Octagon: MCP for Market Data

Octagon：面向公开市场与预测市场情报的 MCP

Octagon MCP 服务通过接入 Octagon Market Intelligence API，提供专业的 AI 驱动金融研究与分析，使用户能够在 Claude Desktop 和其他热门 MCP 客户端中分析并提取公开文件、财报电话会议、财务指标、股票与加密货币数据、股票新闻，以及预测市场新闻与研究的洞见。

工具

✅ octagon-agent 用于统筹广泛的市场情报分析

• 公开市场洞见：SEC 文件（10-K、10-Q、20-F、8-K、S-1、13-F、DEF 14A）、财报电话会议文字稿
• 股票与加密货币市场数据：股票交易、加密货币交易数据、新闻、新闻稿、所有权与持仓

✅ octagon-deep-research-agent 用于全面的深度研究

• 为投资研究问题综合多个来源的信息
• 最适合进行及时的跨来源主题分析

✅ 预测市场研究工具

• octagon-prediction-markets-agent 用于生成各预测市场的最新研究报告
• prediction_markets_history 用于检索结构化历史市场数据

✅ 实时访问 Octagon 文档

• octagon-docs-search、octagon-docs-read、octagon-docs-list 和 octagon-docs-refresh
• MCP 资源：octagon-docs://catalog、octagon-docs://status 和 octagon-docs://page/{target}

获取 Octagon API 密钥

使用 Octagon MCP 需要：

1. 在 Octagon 注册免费账户
2. 登录后，在左侧菜单中前往 API 密钥
3. 生成新的 API 密钥
4. 在配置中将此 API 密钥用作 OCTAGON_API_KEY 的值

先决条件

安装或运行 Octagon MCP 前，需要在系统上安装 npx（随 Node.js 和 npm 一起提供）。

Mac（macOS）

1. 安装 Homebrew（如果尚未安装）：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装 Node.js（包含 npm 和 npx）：

   brew install node
   

   这将安装最新版本的 Node.js、npm 和 npx。

3. 验证安装：

   node -v
   npm -v
   npx -v
   

Windows

1. 下载 Node.js 安装程序：
   • 前往 https://nodejs.org/，下载适用于 Windows 的 LTS 版本。
2. 运行安装程序并按提示操作。这将安装 Node.js、npm 和 npx。
3. 验证安装： 打开命令提示符并运行：

   node -v
   npm -v
   npx -v
   

如果看到这三个工具的版本号，即可继续执行下面的安装步骤。

安装

在 Claude Desktop 上运行

要为 Claude Desktop 配置 Octagon MCP：

1. 打开 Claude Desktop
2. 前往 Settings > Developer > Edit Config
3. 将以下内容添加到 claude_desktop_config.json（将 your-octagon-api-key 替换为你的 Octagon API 密钥）：

{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

4. 重启 Claude，使更改生效

在 Cursor 中运行

配置 Cursor Desktop 🖥️ 注意：需要 Cursor 0.45.6 或更高版本

要在 Cursor 中配置 Octagon MCP：

1. 打开 Cursor 设置
2. 前往 Features > MCP Servers
3. 点击“+ Add New MCP Server”
4. 输入以下内容：
   • Name：“octagon-mcp”（或你偏好的名称）
   • Type：“command”
   • Command：env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp

如果你使用 Windows 且遇到问题，请尝试 cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"

将 your-octagon-api-key 替换为你的 Octagon API 密钥。

添加后，刷新 MCP 服务列表即可查看新工具。Composer Agent 会在适当时自动使用 Octagon MCP；你也可以描述投资研究需求，明确要求使用它。按 Command+L（Mac）打开 Composer，在提交按钮旁选择“Agent”，然后输入查询。

使用 npx 运行

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

手动安装

npm install -g octagon-mcp

文档

如需全面了解如何使用 Octagon Agents，请访问我们的官方文档： https://octagonai.co/docs/

文档包括：

• 详细的 API 参考
• 针对各 Agent 的查询指南
• 示例和用例
• 投资研究最佳实践

如需查看最新的托管 MCP 客户端设置指南，请参阅：

• Octagon MCP 服务指南
• Octagon Claude 插件指南
• Octagon Agents 指南

此 MCP 服务还会直接向 MCP 客户端提供实时文档内容。文档访问通过 Octagon 公共文档的 LLM 入口 https://octagonai.co/docs/llms.txt 获取；不会使用或传输 OCTAGON_API_KEY。

可用工具

MCP 服务目前提供以下工具：

文档工具

这些工具会在 MCP 会话中提供实时 Octagon 文档。即使尚未配置 OCTAGON_API_KEY，也可以使用，因此适用于设置、故障排除，以及查找合适的 Octagon Agent 或 API 工作流。

octagon-docs-list

列出 Octagon 文档内容中的实时文档分区和页面。

参数

• section（string，可选）：按文档分区筛选。
• source（docs、site 或 all，可选）：默认为文档内容。
• limit（number，可选）：返回条目的最大数量。

octagon-docs-search

搜索 Octagon API、Agent、MCP 和插件文档，并提供源 URL 和可选片段。

参数

• query（string，必填）：搜索查询。
• section（string，可选）：按文档分区筛选。
• source（docs、site 或 all，可选）：默认为文档内容。
• limit（number，可选）：返回结果的最大数量。
• includeSnippets（boolean，可选）：在结果中包含匹配的片段。

示例：

Search Octagon docs for Claude plugin connector setup.

octagon-docs-read

按标题、URL、路径或目录 ID，以 Markdown 格式读取一个文档页面或分区。

参数

• target（string，必填）：文档标题、URL、路径或目录 ID。
• source（docs、site 或 all，可选）：默认为文档内容。
• maxChars（number，可选）：返回的 Markdown 字符数上限。
• preferCachedContent（boolean，可选）：如果有可用的已索引文档内容，则使用该内容。

示例：

Read the Octagon MCP server guide.

octagon-docs-refresh

从实时的、适用于 LLM 的文档端点刷新内存中的文档目录。

参数

• includeSite（boolean，可选）：同时刷新更全面的 https://octagonai.co/llms.txt 站点索引。

文档资源

支持 MCP 资源的客户端还可以浏览：

• octagon-docs://catalog：规范化的实时文档目录。
• octagon-docs://status：缓存状态、源端点和刷新元数据。
• octagon-docs://page/{target}：以 Markdown 格式呈现的单个文档页面或分区。

octagon-agent

编排公开市场和私募市场情报分析。

参数

• prompt（字符串，必填）：自然语言研究请求。
• conversation（字符串，可选）：用于继续先前 octagon-agent 对话线程的现有 Octagon 对话 ID。首次调用时省略此参数。
• newConversation（布尔值，可选）：如果为 true，则为当前会话／线程锚点启动新的 Octagon 线程。建议在 Claude Desktop 等顶层宿主中，首次调用全新可见聊天时使用。

线程化用法

octagon-agent 是唯一会转发 Octagon 对话线程信息的 MCP 工具。它是有状态工具，需要会话连续性。MCP 按以下顺序解析会话／线程状态：

1. 用于 MCP 传输会话标识的已存储对话（仅当传输实际提供该标识时）
2. 用于服务端管理的默认 stdio 会话的已存储对话
3. 显式提供的 conversation 仍可在该次调用中覆盖当前会话对话

此软件包目前以 stdio MCP 服务的形式运行。在 stdio 模式下，服务会自动建立进程本地会话，以便在多次调用之间保持连续性。因此，Claude Desktop 或 Cursor 等大多数本地主机无需提供额外的线程字段，即可使用 octagon-agent 实现基本的后续对话行为。

当顶层宿主知道某次调用是新可见聊天的首次交互时，应传入 newConversation: true。这会在调用前显式清除当前 MCP 会话锚点中存储的 Octagon 线程，从而避免 stdio 宿主在多个可见聊天之间复用同一个长期运行的 MCP 进程时出现过时的连续性。

这意味着你可以采用以下任一方式：

1. 首次调用：仅发送 prompt
2. 让 MCP 宿主保留传输会话连续性，或依赖默认的 stdio 会话
3. 第二次调用：任选其一
   • 在同一个 MCP 会话中发送新的 prompt，或
   • 继续使用同一个 stdio MCP 进程，或
   • 显式传入之前的 conversation

对于符合标准的有状态 MCP 传输，传输会话标识是规范的连续性基元。对于本地 stdio 用法，服务端管理的进程会话可提供默认连续性。

会话标识和 Octagon 对话标识是不同的概念：

• MCP 会话标识控制跨工具调用的服务端连续性
• Octagon conversation 控制该会话中的当前 Octagon 线程

MCP 结果会将答案保留在 content 中，并在 structuredContent 中返回供编排器使用的结构化元数据：

{
  "model": "octagon-agent",
  "text": "Which stock would you like the latest price for?",
  "conversation": "conv_123",
  "responseId": "resp_123",
  "followUp": {
    "required": true,
    "inputTemplate": "<ticker or company name>",
    "instructions": "Reply with just the missing detail and reuse the conversation value from this response."
  }
}

显式传递对话示例：

{
  "prompt": "AAPL",
  "conversation": "conv_123"
}

新建可见聊天示例：

{
  "prompt": "Analyze Apple",
  "newConversation": true
}

显式刷新示例：

{
  "prompt": "Start a fresh Octagon thread for this chat",
  "newConversation": true
}

有状态工具策略

• octagon-agent：有状态，使用有效的连续性锚点。在 stdio 宿主中，除非你提供显式的 conversation，否则默认使用服务端管理的进程会话
• 其他 MCP 工具：无状态，可在没有会话连续性的情况下运行

示例：

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

更多示例：

• “Amazon 在 2023 年第四季度的收入和净利润分别是多少？”
• “分析 Tesla 过去 3 年的研发支出趋势。”
• “NVIDIA 首席执行官在最近一次财报电话会议中对 AI 芯片需求作出了怎样的预测？”
• “比较市值排名前 5 的半导体公司的市盈率、市销率和 EV/EBITDA 比率。”
• “Anthropic 最近一轮融资的规模、估值和主要投资者有哪些？”
• “Andreessen Horowitz 过去 12 个月在 AI 初创公司中进行了多少笔投资？”
• “过去一周 NVIDIA 股票的最新新闻文章有哪些？”

octagon-deep-research-agent

执行全面的多来源深度研究与综合分析。

参数

• prompt（string，必填）：自然语言研究请求。

示例：

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

更多示例：

• “从 zillow.com/san-francisco-ca/ 提取所有数据字段”
• “研究 Apple 的隐私政策变化对数字广告公司的收入和利润率造成的财务影响”
• “获取 2023 年的历史 Bitcoin 价格数据，并分析价格波动趋势”
• “分析电动汽车充电基础设施市场的竞争态势”

octagon-prediction-markets-agent

为 Kalshi 预测市场事件生成研究报告。

参数

• prompt（string，必填）：自然语言研究请求。
• cache（boolean，可选）：控制 Agent 变体的路由。
  • 省略：prediction-markets-agent
  • false：prediction-markets-agent:refresh
  • true：prediction-markets-agent:cache

示例：

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

prediction_markets_history

获取预测市场事件代码的历史数据，并支持可选的分页和时间筛选条件。

参数

• event_ticker（string，必填）
• limit（number，可选）
• cursor（string，可选）
• captured_from（string，可选）
• captured_to（string，可选）
• include_analysis（boolean，可选；为 true 时，请求分析列）

示例：

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

故障排除

1. API 密钥问题：确保已在环境或配置文件中正确设置 Octagon API 密钥。
2. 连接问题：确保与 Octagon API 的连接正常。
3. 速率限制：如果遇到速率限制错误，请降低请求频率。

许可证

MIT

独立的专用 MCP 服务

此服务通过整合所有专用 Agent，提供全面的市场情报；你也可以根据特定使用场景使用我们的独立 MCP 服务：

研究工具

• Octagon Deep Research MCP - 全面的研究和网页抓取能力

---

⭐ 如果你觉得这个仓库有帮助，请为它点个 Star！