Equibles

Equibles — 股票市场与金融数据 MCP 服务

为 Claude、ChatGPT 和 Cursor 等 AI Agent 提供 130 个 MCP 工具：SEC 文件、基本面数据、13F 机构持仓、内部人士和国会议员交易、财报电话会议文字稿、期权链、实时报价、IPO 文件、空头持仓、宏观数据，以及你自己的投资组合。提供免费托管方案，也可自行托管开源技术栈。

这是什么？

模型上下文协议（MCP）让 AI 助手能够调用外部数据工具，而不是根据训练数据猜测。Equibles 将美国股票市场和金融数据作为 MCP 服务提供：可使用托管服务 https://mcp.equibles.com/mcp（免费 API 密钥，也可完全不使用密钥，通过 OAuth 登录），也可使用开源技术栈自行运行。所有数据均解析自一手来源（SEC EDGAR、FINRA、FRED、CFTC、CBOE、USAspending 和公司投资者关系网站），而非第三方估算。

许可证

此发现仓库的文档和元数据采用 MIT 许可证。可自托管的服务实现位于 daniel3303/Equibles，采用 AGPL-3.0。托管服务受 Equibles 服务条款约束。

快速入门（托管服务，30 秒）

1. 在 equibles.com 创建免费账户——无需信用卡。
2. 在 https://equibles.com/dashboard/apikeys 创建 API 密钥。密钥以 eq_ 开头，且只会显示一次，请立即复制。
3. 使用网址 https://mcp.equibles.com/mcp 连接客户端（见下文）。

ChatGPT 和 Claude（网页端和桌面端）可跳过密钥，直接通过 OAuth 登录。

连接你的 AI 客户端

插件包

此仓库包含适用于 Cursor 等兼容客户端的 Agent Plugins 包（plugin.json 和 mcp.json）、Grok Build 包（.grok-plugin/plugin.json 和 .mcp.json）、Codex 插件和市场（.codex-plugin/plugin.json、.agents/plugins/marketplace.json 和 .mcp.json）、Claude Code 插件和市场（.claude-plugin/plugin.json 和 .claude-plugin/marketplace.json），以及 Gemini CLI 扩展（gemini-extension.json）。skills/ 文件夹包含一个研究技能，任何能够发现技能的包加载器都会加载它，包括 Codex 和 Claude Code 插件及 Agent Plugins 客户端。这些文件用于配置托管的 MCP 端点；其中不包含服务端实现。市场是否提供，与这些可安装包无关。

除 Claude Code 插件使用 https://mcp.equibles.com/mcp（与 Claude 目录连接器保持一致）外，这些包都通过 https://mcp.equibles.com/mcp?auth=oauth 使用由客户端管理的 OAuth。对于其他包，查询参数会在发现阶段请求身份验证，因此客户端会在尝试查询数据前提示登录。收到提示时，请登录 Equibles 账户。在 Gemini CLI 中，如有需要，可使用 /mcp auth equibles。如果客户端不支持 OAuth，请改用下方的 API 密钥配置。

从此仓库安装 Gemini CLI 扩展：

gemini extensions install https://github.com/daniel3303/stock-market-mcp-server

如需在本地检出此包，请使用 gemini extensions link /absolute/path/to/stock-market-mcp-server。检查包后，Grok Build 用户可以运行 grok plugin install /absolute/path/to/stock-market-mcp-server --trust，然后运行 grok plugin enable equibles 并启动新会话。

从此仓库的市场安装 Codex 插件：

codex plugin marketplace add daniel3303/stock-market-mcp-server
codex plugin add equibles@equibles

这些包配置的 MCP 端点只有 https://mcp.equibles.com/mcp?auth=oauth，以及 Claude Code 插件中的 https://mcp.equibles.com/mcp。OAuth 发现和登录使用 https://equibles.com/。查询和明确请求的投资组合更改会在已登录账户下发送至 Equibles。请保持客户端的常规工具确认功能处于启用状态：投资组合工具可以创建、更改或删除已保存的持仓；反馈工具会向 Equibles 发送报告。这些包不包含可执行脚本、生命周期钩子、嵌入式凭据或遥测代码。请按照 SECURITY.md 中的说明报告安全问题。托管服务的使用受账户权限和服务条款约束。

Cline

按照上方的快速入门创建 Equibles 账户和 API 密钥。在 Cline 中，打开 MCP Servers → Configure MCP Servers，并将此条目合并到 mcpServers 对象中，将 eq_your_api_key 替换为你自己的密钥：

{
  "mcpServers": {
    "equibles": {
      "type": "streamableHttp",
      "url": "https://mcp.equibles.com/mcp",
      "headers": { "Authorization": "Bearer eq_your_api_key" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

请将密钥保存在本地客户端配置中，切勿提交。保存配置，确认 Equibles 已连接，然后让 Cline 调用 GetMarketStatus，进行只读连接检查。如果身份验证失败，请检查密钥，或通过客户端的 OAuth 流程登录。客户端设置请参阅 Cline MCP 文档。

Claude Desktop / Claude web (claude.ai)

设置 → 连接器 → 添加自定义连接器 → URL https://mcp.equibles.com/mcp → 通过 OAuth 登录（无需密钥）。

密钥替代方案：使用 URL https://mcp.equibles.com/mcp?api_key=eq_your_api_key。

Claude Code

claude mcp add --transport http equibles https://mcp.equibles.com/mcp

然后运行 /mcp 并选择 Authenticate，通过 OAuth 登录。

或者安装插件，它会添加相同的服务和研究技能：

/plugin install equibles --marketplace daniel3303/stock-market-mcp-server

对于早于 2.1.275 的 Claude Code 版本，请先运行 /plugin marketplace add daniel3303/stock-market-mcp-server，然后运行 /plugin install equibles@equibles。

此插件使用与 Claude 目录中的 Equibles 连接器相同的服务 URL；运行 /mcp 并选择 Authenticate 以登录。

密钥替代方案：

claude mcp add-json equibles '{"type":"http","url":"https://mcp.equibles.com/mcp","headers":{"Authorization":"Bearer eq_your_api_key"}}' --scope user

ChatGPT

添加开发者模式连接器，URL 为 https://mcp.equibles.com/mcp，并完成 OAuth 登录（或使用 ?api_key=eq_your_api_key URL）。

Cursor

添加到 ~/.cursor/mcp.json：

{ "mcpServers": { "equibles": { "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }

VS Code（Copilot）

code --add-mcp '{"name":"equibles","type":"http","url":"https://mcp.equibles.com/mcp"}'

或者添加 .vscode/mcp.json，其中包含一个使用相同 URL 和 Authorization 标头格式的 "servers" 对象：

{ "servers": { "equibles": { "type": "http", "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }

任意 MCP 客户端

使用 HTTP 传输，URL 为 https://mcp.equibles.com/mcp，通过 Authorization: Bearer eq_... 标头或 ?api_key=eq_... 查询参数进行身份验证。

连接后，请参阅完整的客户端指南：https://equibles.com/docs/mcp。

示例提示词

• “上个季度哪些对冲基金买入的 NVIDIA 最多？”
• “总结 Tesla 最新 10-K 中的风险因素。”
• “显示 Microsoft 近期的内部人士抛售情况，以及今年是否有国会议员交易过该股票？”
• “NVIDIA 对下一季度的业绩指引是什么？它报告了哪些关键绩效指标？”
• “今天哪些股票的逼空评分最高？”
• “筛选市盈率低于 20 且盈利的软件股。”
• “最新的 CPI 和失业率是多少？”

工具

共 130 个工具，按数据集分组。其中 120 个用于读取市场数据，标有 ✏️ 的 10 个可用于写入你自己的投资组合、自选列表或反馈。

申报文件与文档

工具	描述
SearchDocuments	在申报文件语料库中进行关键词与语义混合搜索。
SearchDocument	在由 ListFilings 返回的 UUID 标识的单个文档中执行搜索。
ListFilings	按时间倒序列出已存储的申报文件和文字记录（先按申报日期，再按 EDGAR 接收时间），并支持分页。
ReadDocumentLines	读取文档中指定范围的编号行。
GetFormDOfferings	按时间倒序列出公司近期通过 SEC Form D 公告披露的 Regulation D 私募发行。

基本面与估值

工具	描述
GetFinancialFact	返回单个 XBRL 财务概念（如收入、净利润、稀释每股收益、总资产、经营现金流等）的时间序列，数据取自 SEC Company Facts：对于收入等流量项目，每个财务期间一行；对于余额和股数，每个截至日期一行，因此封面页的股数和期末资产负债表中的股数都会显示。
CompareFinancialFact	比较多家公司在同一财务期间的某个财务概念，以同业表格形式呈现，每个股票代码一行，显示最新重述值；该期间没有数据的股票代码会单独列出。
GetFinancialStatement	返回某一财年的一个期间的完整损益表、资产负债表或现金流量表，数据取自 SEC Company Facts（XBRL）。
GetRevenueBreakdown	按业务板块、地理区域和产品／服务拆分收入，基于发行人在其文件中自行标记的维度 XBRL 事实构建。
GetCompanyKpis	提取公司自行披露的关键绩效指标，来源为其书面 Item-2.02 8-K 财报新闻稿和 10-K／10-Q MD&A。
GetNonGaapBridge	提取公司财报新闻稿和 10-K／10-Q 定期报告中针对每项已披露非 GAAP 指标（如调整后 EBITDA、调整后 EPS 或调整后营业收入）的 GAAP 到非 GAAP 对账“桥接表”：包括 GAAP 起始值、按顺序列出的各项披露调整，以及非 GAAP 结果，并附上期间、单位和原文引述；经核验人员批准，最新文件优先。
GetGuidance	提取管理层发布的前瞻性指引区间，来源为 Item-2.02 8-K 财报新闻稿和财报电话会议文字稿（部分发行人，例如
GetValuationMultiples	显示滚动 12 个月 EV／Revenue、EV／EBIT 和 P/E，并与剔除目标公司后的同业中位数、四分位数及各项比率的实际同业样本进行比较。
GetValuationMultiplesHistory	按每个过去季度的文件提交日期重新计算 EV／Revenue、EV／EBIT、EV／EBITDA 和 P/E，每季度一行，最长约 10 年。
GetCustomerConcentration	提取公司披露的客户集中度风险，例如“某一客户占收入的 26%”。该工具可直接处理两种权威文件格式。
GetGoingConcernStatus	判断公司最近审查的 SEC 文件是否声明公司持续经营能力存在重大疑虑（并提供披露原文、来源文件，以及审查文件历史，显示疑虑何时出现、得到缓解或已消除）。

债务概况

工具	描述
GetDebtProfile	返回公司披露的债务总额历史记录，以及每项已识别票据、贷款和循环信贷额度的当前状态摘要。
GetDebtInstrument	返回概况中的一项长期债务工具，包括其当前披露余额及截至日期、分页显示的关联文件观察历史、当前有效且经核验的契约条款，以及管辖、修订、再融资或退役相关文件。

财报电话会议与投资者关系

工具	描述
GetEarningsBrief	经验证人员核准的公司最近财报电话会议定性解读，按季度从新到旧排列。
GetEarningsCallToneAndThemes	AI 对公司近期财报电话会议的评分解读，按时间从新到旧排列。
GetEarningsCallThemeHistory	公司电话会议主题如何逐季度变化。
GetTranscriptPhraseTrend	某个词或短语在公司最近几次财报电话会议中出现的频率，按会议从旧到新排列。
GetEarningsCallEvent	将一个财季的财报电话会议相关材料（音频、文字稿、幻灯片和 8-K 财报新闻稿）归为一条记录的单个事件条目。
GetEarningsCallTranscript	公司特定财季财报电话会议的发言人标注文字稿。
GetEarningsCallQuestions	电话会议问答环节中分析师提出的问题，每位分析师每次发言单独列为一条记录，并包含后续追问，按提问顺序排列。
GetInvestorEventSlideMetadata	已捕获的投资者活动幻灯片的元数据和访问链接。
ListInvestorEvents	公司近期的投资者活动（财报电话会议及其网络直播的其他活动，包括会议、投资者日、分析师日和股东大会），按时间从新到旧排列。
GetInvestorEventTranscript	按活动 ID 获取特定投资者活动的发言人标注文字稿。
GetInvestorRelationsNews	股票近期的投资者关系新闻稿，直接从公司自己的投资者关系网站抓取，包括标题、发布日期、来源提供时的单行摘要和链接，按时间倒序排列。
GetUpcomingInvestorEvents	股票未来的投资者关系日程（财报网络直播、会议演讲、演示和股东大会），从公司投资者关系网站抓取，列出从现在起安排的活动，按时间从近到远排列（截至此次采集，NVIDIA 没有即将举行的活动，因此下面的示例使用 Microsoft）。
GetShareholderVoteResults	公司股东大会投票结果，取自其 SEC 8-K 文件的 Item 5.07 部分，按会议时间从近到远排列。

分析师预估

工具	描述
GetAnalystEstimates	读取某家公司的已存储分析师一致预期。

机构持仓（13F）

工具	描述
GetTopHolders	根据最新的 13F 申报，列出某只股票中已追踪机构持仓记录的排名。
GetInstitutionalOwnershipHistory	展示近期各季度某只股票的汇总申报 13F 持仓趋势、申报机构数量、申报总股数、公布的汇总持仓市值，以及同口径的季度环比变化：仅统计两个季度均有可查 13F 的机构；每个季度还会列出被排除的机构及其股份（申报延迟或保密、首次申报、账目不匹配的 CIK 变更），因为缺少申报并不代表发生了交易。
GetHolderMix	按一个维度逐季度细分某只股票的 13F 持有者。
GetTopInstitutionalBuyersSellers	列出本季度对某只股票影响最大的机构，并提供两个排名表：与上一份 13F 申报日期相比，绝对增持股数最多的机构（最大买家）和绝对减持股数最多的机构（最大卖家）。
GetInstitutionPortfolio	列出某家指定机构按公布市值排列的最大 13F 持仓，并显示每项持仓的类型、股数、市值和占已追踪投资组合的比例。
GetInstitutionSummary	返回 13F 申报机构的投资组合概要，包括已追踪投资组合公布市值、持仓数量、前 10 和前 25 大持仓集中度、季度环比换手率、最新和上一申报日期，以及已记录的季度数。
GetInstitutionStyleHistory	按季度展示 13F 申报机构的投资组合表现，依据其申报的普通股持仓进行衡量。
GetInstitutionSectorAllocation	按行业／板块拆分某家机构最新的 13F 投资组合，并按权重排序，同时列出各板块的持仓数量、公布的美元市值及占已追踪投资组合的比例。
GetInstitutionQuarterlyActivity	将某家机构的 13F 与紧邻的上一季度进行比较，并将变化分为四类（新建仓、增持、减持和清仓），每类均按市值绝对变化排序。
SearchInstitutions	按申报名称中的词语或 CIK 前缀搜索已追踪的 13F 申报机构，并包含当前主要申报机构经核实的品牌别名。
GetMarketWide13FActivity	返回全市场 13F 排行榜，可选择一个类别，按各申报机构相较上一季度的汇总变动为股票排名。
GetHolderTypeFlows	展示已结束季度中按 13F 申报机构类型划分的全市场资金流向。
GetMostHeldStocks	按某季度的机构 13F 持有广度为股票排名；默认依据申报持有该股票的机构数量，也可按申报机构数量的季度环比变化（升温／降温热力图）或公布的持仓总市值排名。
GetSuperInvestors	返回精选的超级投资者目录，收录知名价值投资者和基金经理（Warren Buffett、Bill Ackman、Michael Burry、Seth Klarman 等），并列出每人的 13F 申报机构 CIK、最新公布的已追踪投资组合市值、持仓数量、季度环比变化及申报日期。

ETF

工具	描述
SearchEtfs	按代码、基金名称或发起方搜索仍在运作的交易所交易基金及产品。
GetEtfProfile	返回 ETF 专属概况，包括精确匹配代码的结算价格和总回报表现、52 周区间、平均成交量、SEC 申报资产、前十大持仓集中度、资产配置及十大持仓。
GetEtfHoldings	返回 ETF 根据最新 Form NPORT-P 报告保存的投资组合，并按市值排序。

基金与顾问

工具	描述
SearchFunds	按基金名称、注册人、标识符或任意顺序的股票代码词，搜索已追踪的注册管理型投资公司和提交 SEC Form NPORT-P 的 UIT ETF 目录。
GetFundProfile	返回注册基金的概况，以及其最新 SEC Form NPORT-P 中持仓规模最大的资产。
GetFundNcenReports	返回注册投资公司 SEC Form N-CEN 年度报告中的运营数据。
GetFundsHoldingStock	根据 SEC Form NPORT-P 投资组合报告，返回持有指定股票或 ETF 上市证券的注册基金和 ETF。
GetEuropeanFundHoldings	返回报告持有一只美国境外上市证券的欧洲投资基金，证券以 MIC:TICKER 格式表示，并按该证券的 ISIN 匹配。
CompareInstitutionPortfolios	返回两家机构管理人在最新共同报告日期的 13F 投资组合重合情况，包括持仓并集和共有持仓数量、Jaccard 相似度、按美元加权的重合度，以及并列展示的股票表，其中列出各管理人的持股数量及其占已追踪投资组合的百分比。
GetInstitutionConsensusHoldings	返回 2–25 家机构管理人在最新共同报告日期的共识／合并投资组合。
GetInstitutionCloneBacktest	回测克隆某机构申报者所报告的 13F 投资组合，在过去一段时间内相较市场基准的表现。
SearchInvestmentAdvisers	按公司名称搜索在 SEC 注册的投资顾问和豁免申报投资顾问（Form ADV）。
GetInvestmentAdviser	按 Organization CRD 编号返回单个在 SEC 注册的投资顾问或豁免申报投资顾问的完整 Form ADV 概况。

内幕交易

工具	描述
GetInsiderTransactions	直接从 SEC Forms 4 和 5 返回某只股票最新的内幕交易。
GetInsiderOwnership	返回公司内部人士（董事、高管和持股 10% 的股东）名单，并列出每人的职位、持股总数、最近一次交易的类型和日期，按持股数量从多到少排序。
GetForm144ProposedSales	返回某只股票近期的 Form 144 通知，即关联方预先申报拟出售受限股或控制股的意向。
GetInsiderSentimentScores	在过去 90 天的滚动窗口内，按综合 0–100 内幕情绪评分对整个评分范围进行排名。该评分结合三个考虑方向的同业相对指标（买入的不同内部人士净人数、净买入股数占流通股数的比例，以及内部人士净买入美元金额），且仅依据公开市场 Forms 4/5 买入和卖出交易计算。
SearchInsiders	按完整姓名词语查找已追踪的公司内部人士（董事、高管和持股 10% 的股东），不匹配任意子字符串。
GetEuropeanDirectorTransactions	返回欧洲监管机构发布的某只美国境外上市证券的董事及关联人士（PDMR）交易，证券以 MIC:TICKER 格式表示。

国会议员交易

工具	描述
GetCongressionalTrades	返回指定股票代码的国会议员申报交易，按时间从新到旧排列。
GetMemberTrades	返回某位国会议员申报的交易，按时间从新到旧排列。
GetMemberNetWorth	根据年度财务披露报告重建并返回某位国会议员的净资产历史。
GetMarketWideCongressionalActivity	汇总过去一段时间内所有国会议员和所有股票代码的交易活动，无需指定股票代码或议员姓名，即可了解“国会最近买入（或卖出）了什么”。
SearchCongressMembers	按不区分标点且顺序不限的姓名词语搜索已追踪的国会议员名录。

做空

工具	描述
GetShortVolume	FINRA 发布的单只股票每日卖空成交量。
GetShortInterest	FINRA 发布的单只股票双月卖空持仓报告。
GetOffExchangeVolume	FINRA 场外交易／ATS 透明度数据中的单只股票每周场外交易量。
GetFailsToDeliver	返回股票或 ETF 的 SEC 未交收（FTD）记录，按时间从早到晚排列。
GetShortInterestSnapshot	截至最近 FINRA 卖空持仓结算日的全市场排行榜，按补仓天数降序排列，让最容易发生轧空的股票优先显示。
GetLargestShortVolume	单个交易日卖空成交量最大的上市证券（包括 ETF），默认使用最近可用日期；按卖空成交量降序排列，并提供股票代码、卖空成交量、豁免卖空成交量、总成交量和卖空比例。
GetShortSqueezeScores	全市场综合轧空评分（0–100）最高的股票排行榜；根据截至最近结算日的卖空持仓，在主营业务公司股票中按同类比较排名。
GetEuropeanShortPositions	披露给欧洲监管机构的美国以外单一上市证券净空头头寸，格式为 MIC:TICKER；根据该证券的 ISIN 匹配，或对于瑞典等按发行人披露的来源，根据发行人的 LEI 匹配。

资本、管理层与筛选

工具	描述
GetBuybackPrograms	根据 XBRL 事实及对申报文件叙述内容的核实提取，提供公司的股票回购情况（跟踪中的计划（授权总额、剩余金额、到期时间）、最新授权，以及按财年列出的回购历史（现金支出、股数、平均价格））。
GetAtmPrograms	市价发行（ATM）股票计划：公司通过已签署的销售／分销协议直接向市场出售新股。
GetExecutiveChanges	从 Item-5.02 8-K 申报文件中提取高管和董事的任命及离任信息（包括人员、申报文件中的原始职务描述、单独归一化的职务分类、变动性质、生效日期、逐字披露内容，以及来源 8-K 的链接）。
GetExecutiveCompensation	公司 DEF 14A 薪酬汇总表中的指定高管薪酬，按财年列出薪金、奖金、股票和期权奖励、非股权激励、其他薪酬，以及公司报告的总额。
ScreenStocks	通过组合不同数据集的区间筛选条件，筛选美国上市证券，或具有市场信息的欧洲、中国和香港上市证券。
GetGovernmentContracts	公司从 USAspending 获得的联邦合同授予信息，包括授予日期、政府所列的受领方、授予机构、授予类型、总金额、履约期结束日期、授予 ID 和描述。
GetTopGovernmentContractors	在指定时间范围内获得最多联邦合同金额的公司，按授予总额排名，并提供授予数量。
GetFdaAdvisoryCommitteeMeetings	已安排的 FDA 咨询委员会会议，按日期从近到远排列，包括日期、会议标题、FDA 中心、类型，以及指向各会议 FDA 页面（唯一列出待审产品和申办方的页面）的链接。

价格与技术指标

工具	描述
GetStockPrices	单只股票的每日 OHLCV 数据，每个交易日一行，包含开盘价、最高价、最低价、收盘价和正数的成交股数，按时间从旧到新排列。
GetLatestClosingPrices	一次调用即可获取最多 25 个股票代码最近的成交收盘价、单日涨跌、成交股数和过去 52 周的价格区间。
GetDividendHistory	特定股票或 ETF 上市证券已存档的现金股息公告，按除息日期从新到旧排列。
GetLiveQuote	GetLiveQuote 会先检查实时服务当前的内存快照。
GetBollingerBands	单只股票的布林带。
GetStochasticOscillator	单只股票的随机振荡指标。
GetAverageTrueRange	单只股票的 Wilder 平均真实波幅（ATR）（一种波动率指标，根据真实波幅（最高价−最低价、/最高价−前收盘价/ 和 /最低价−前收盘价/ 中的最大值）计算，并在 period 天内递归平滑），与每日收盘价并列显示，按时间从新到旧排列。
GetOnBalanceVolume	单只股票的能量潮指标（OBV）。
GetCorrelatedStocks	与单只股票的每日收益率相关性最高（或最低）的股票。

期权

工具	描述
GetOptionExpirations	标的证券的已上市到期日，按升序排列，并列出每个日期的有效合约数量。
GetOptionChain	单个到期日的看涨和看跌期权链：行权价、类型、每日最新价格、带日期的未平仓合约数、隐含波动率和希腊值（delta、gamma、theta、vega）。
GetOptionContract	根据 OCC 代码查询单个期权合约：每日最新价格和价格区间、带日期的未平仓合约数、隐含波动率、希腊值，以及与权限等级相应的买价/卖价。

经济数据、期货与市场情绪

工具	描述
GetEconomicIndicator	单个 FRED 经济序列的观测历史，每个周期一行，包含数值，以及序列标题、单位、频率和季节性调整标记。
GetLatestEconomicIndicators	所有受追踪 FRED 序列的最新读数，按类别分组，作为一目了然的宏观数据面板。
SearchEconomicIndicators	按精确 ID、已验证的常用别名或任意顺序的标题/主题词搜索受追踪的 FRED 序列。
GetEconomicCalendar	经济数据发布日历：默认显示即将发布的日期；如果 startDate 在过去，则显示近期日期。
GetMarketStatus	根据交易所整理的节假日和提前收盘日历，以东部时间计算美国股票市场当前是否开市、当前交易时段以及下次开市和收盘时间。
GetMarketHolidayCalendar	美国市场的节假日和提前收盘时间（下午 1:00
GetCftcPositioning	单一期货合约的每周交易者持仓报告（COT）持仓情况。
GetLatestCftcPositioning	所有受追踪合约的最新 COT 快照，按类别（农业、能源、金属、股票指数、利率、货币）分组，一目了然地展示未平仓合约数以及商业/非商业净持仓。
SearchCftcMarkets	按精确市场代码、已验证的标准代码/常用别名或任意顺序的名称词搜索受追踪的 CFTC 期货合约集合。
GetPutCallRatios	单种比率类型的 CBOE 看跌/看涨比率历史记录（默认按股票计算）：每个日期的看涨和看跌成交量、总量以及 P/C 比率。
GetVixHistory	CBOE VIX 每日 OHLC 序列（市场的“恐惧指数”），数据可追溯至 1990 年。

IPO

工具	描述
GetIpoFeed	返回受追踪的注册信息，按申报活动从新到旧排列。
GetIpoDetails	根据 SEC CIK 返回某项注册的完整信息。

股票指数

工具	描述
GetIndexComposition	返回某个指数当前的成分股列表，按权重从高到低排列，并列出每家公司在指数中的占比，以及跟踪基金对该公司的持仓。
GetIndexChanges	返回加入或退出某个指数的公司，按时间从近到远排列。
GetIndexForecast	根据某个指数自行公布的纳入规则，对我们跟踪的每家公司进行评估。

你的投资组合

工具	描述
GetMyPortfolio	查看你的持仓及其价格、成本基础、未实现利润，以及已平仓批次的已实现利润。
CreateMyPortfolio ✏️	创建一个新的空投资组合。
AddPortfolioLot ✏️	记录一笔买入或卖出。
UpdatePortfolioLot ✏️	修正你已记录的批次：数量、价格、日期、备注或汇率输入错误。
ClosePortfolioLot ✏️	记录你已按指定价格在指定日期卖出、平仓或任由某个批次到期。
RemovePortfolioLot ✏️	永久删除某个批次，就像它从未被记录过一样。
WatchInstrument ✏️	将股票或期权合约添加到投资组合的关注列表，但不记录任何持仓。
UnwatchInstrument ✏️	从投资组合的关注列表中移除某个标的。
DeleteMyPortfolio ✏️	永久删除一个投资组合及其中的所有批次，无论批次是否已平仓，也包括已实现利润历史记录。

跟踪器

工具	描述
ListWebDataFeeds	列出调用者的跟踪器及其标识符、启用或暂停状态、可见性、来源访问权限、计划、下次采集时间和最近一次运行状态。
GetWebDataFeed	默认读取最近一次经独立验证的成功结果及其捕获的来源 URL。

供应链

工具	描述
GetSupplyChain	查询一家公司的供应链。
GetSupplyChainOverlap	查询某家公司的供应商和客户中，哪些也向其上市竞争对手供货或从其采购；数据来自与 GetSupplyChain 相同的 10-K 阅读内容。
GetOrganization	查询一个未被我们覆盖的任何市场列出的组织：美国。

Agent 反馈

工具	描述
ReportProblem ✏️	报告你实际调用的 Equibles 工具：该工具调用失败、超时、意外返回空结果（ToolFailed），或返回经证实不可能或自相矛盾的数据（ImplausibleResult）。
SuggestToolImprovement ✏️	当你实际调用的现有 Equibles 工具按文档正常运行，但缺少有用的操作、筛选条件、参数或输出选项时，提出最小且可执行的契约改进建议。

定价与速率限制

计划	每日请求数	价格	需要银行卡
Free	100 requests/day	$0	否
Plus	10,000 requests/day	查看定价	是
Pro	100,000 requests/day	查看定价	是

• MCP 服务和 REST API 共用一个每日计数器；计数器于 00:00 UTC 重置。
• 响应中会提供速率限制标头：X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset，以及 Retry-After（适用于 429）。
• 超过限制时，MCP 服务会在带外返回正常的工具结果，说明限制情况，而不是返回不透明的错误，以便 Agent 读取并做出响应。

详情请见https://equibles.com/pricing。

使用 Docker 自托管（开源）

完整技术栈已在 https://github.com/daniel3303/Equibles 开源。

git clone https://github.com/daniel3303/Equibles
cd Equibles
docker compose up

MCP 服务将在 http://localhost:8081/mcp 启动。默认情况下无需 API 密钥；设置 MCP_API_KEY 环境变量后，必须在请求头中提供 Authorization: Bearer <key>。自托管时，Bearer 请求头是唯一的身份验证方式（不支持查询参数或 OAuth）。

自托管服务提供 64 种开源工具：13F 持仓、内幕交易、SEC 文件与基本面、基金/ETF/顾问、FRED、CFTC、CBOE、国会议员交易、做空数据、股票价格、政府合同和 FDA 日历。托管服务在此基础上还提供另外 44 种工具：财报电话会议、业绩指引、KPI、筛选器、估值倍数、股票回购、高管数据、实时行情、期权链、IPO 文件和个人投资组合。

注意：自托管技术栈会从一手来源运行自己的抓取程序，因此数据库初始为空，启动后会逐步填充数据。

REST API

所有功能也可通过常规 REST API 使用，API 地址为 https://api.equibles.com/v1，与 MCP 服务共用 API 密钥和每日限额。文档见 https://equibles.com/docs。

数据来源与方法论

所有数据集均从一手来源解析，绝不使用第三方估算：

• SEC EDGAR — 文件、XBRL 基本面、13F 持仓、Forms 3/4/5/144、NPORT、ADV、N-CEN、Form D
• FINRA — 做空成交量、做空权益、暗池/场外成交量
• FRED — 经济指标和宏观序列
• CFTC — 交易者承诺报告中的期货头寸
• CBOE — 看跌/看涨比率和 VIX
• USAspending.gov — 联邦政府合同授予
• 公司 IR 网站 — 投资者关系新闻和活动
• 国会披露 — 国会议员交易和净资产

方法论详情见 https://equibles.com/docs/methodology。

链接

• 网站：https://equibles.com
• 文档：https://equibles.com/docs
• 创建 API 密钥：https://equibles.com/dashboard/apikeys
• 开源技术栈：https://github.com/daniel3303/Equibles
• 定价：https://equibles.com/pricing