XOOMAR market data

xoomar-mcp

一个 MCP 服务，为 AI agents 提供 XOOMAR 免费市场数据 API 工具：包含 26 个工具，覆盖 31 个数据集，数据来自一手来源（SEC EDGAR 和 XBRL、FINRA、CFTC、美联储、USAspending 和交易所 API）。无需密钥即可开始使用。

使用方法

托管服务，无需安装： https://xoomar.com/mcp（Streamable HTTP）。可将其添加为远程 MCP 服务或自定义连接器，在 Claude.ai、Claude Code（claude mcp add --transport http xoomar https://xoomar.com/mcp）、ChatGPT、Cursor 或任何通过 URL 连接的客户端中使用。使用免费账户密钥发送 Authorization: Bearer <key> 或 X-API-Key，每分钟可请求 30 次；不使用密钥时，每个 IP 每分钟限 10 次。无密钥和免费密钥请求均可返回最多六个月的历史数据。

本地运行，通过 stdio： Claude Desktop（claude_desktop_config.json）、Claude Code、Cursor、Windsurf，以及其他可启动 stdio 服务的 MCP 客户端：

{
  "mcpServers": {
    "xoomar": {
      "command": "npx",
      "args": ["-y", "xoomar-mcp"]
    }
  }
}

Claude Code，一行命令：

claude mcp add xoomar -- npx -y xoomar-mcp

作为库使用（托管端点就是以这种方式构建的）：

import { buildServer } from "xoomar-mcp";
const server = buildServer({ apiKey: "xm_live_...", maxRows: 100 }); // an McpServer with the 26 tools; connect any transport

stdio 可执行文件的可选环境变量：XOOMAR_API_KEY（在 https://xoomar.com/signup 获取免费账户密钥，可将请求上限从每分钟 10 次提高到 30 次；无密钥和免费密钥请求均可返回最多六个月的历史数据）、XOOMAR_MAX_ROWS（每个工具结果的行数，默认为 200）。

工具

工具	返回内容
short_interest	FINRA 卖空持仓量及回补天数，按结算日期划分
short_volume	FINRA 每日卖空成交量及卖空成交量占比，数据始于 2021 年
fails_to_deliver	SEC 按结算日期统计的交割失败数据，始于 2010 年
insider_trades	SEC Form 4 内部人交易
insider_clusters	在一段时间内有多名内部人在公开市场买入的公司
threshold_list	Reg SHO 门槛证券名单（Nasdaq 和 Cboe，始于 2022 年）
planned_insider_sales	SEC Form 144 拟售通知
large_holders	持股超过 5% 的 Schedule 13D 和 13G 持有人
fund_holders	跟踪的 13F 管理机构中，哪些机构持有某个股票代码
fund_portfolio	某个跟踪管理机构最新的 13F 投资组合
company_financials	基于 XBRL 的季度和年度数据及资产负债表
earnings_calendar	根据 8-K Item 2.02 文件整理的已公布财报日期，以及每家公司的下一预计日期（含估算及其依据）
corporate_events	按条目分类的 8-K 重大事件
cot_positioning	CFTC 交易者持仓报告，可查看最新数据或某个市场的历史数据
funding_rates	Binance、Bybit、OKX、Hyperliquid 和 Kraken 的永续合约资金费率（BitMEX 历史数据截至 2026 年 9 月 16 日，该平台于当日关闭其掉期合约）
fed_liquidity	净流动性及其组成部分，或某个 FRED 系列
policy_rates	央行政策利率，涵盖有当前数据系列的 38 个经济体
macro_series	美国收益率曲线、利差、稳定币供应量
treasury_auctions	自 2010 年起的国债拍卖结果和日程
economic_calendar	根据各机构日程整理的 22 种美国经济数据发布类型，发布后附实际值
private_placements	SEC Form D 私募发行
ipo_pipeline	S-1、F-1、424B4、EFFECT 和 RW 文件
bitcoin_treasuries	上市公司持有的比特币
federal_contracts	按上市母公司划分的美国联邦合同事项
crypto_market	未平仓合约量、强制平仓、期权指标、大户持仓
api_reference	底层 API 的工作方式

每个结果都包含 updatedAt、source（数据发布方：FINRA、SEC、CFTC 或交易所）、sourceAttribution（展示数据时应附上的署名）以及署名信息。你可以询问：“GME 的卖空持仓量今年有何变化？”“上个季度哪些跟踪的基金买入了 NVDA？”“美联储净流动性有什么变化？”“展示过去 7 天的公开市场内部人买入记录”。

收录位置

已收录于官方 MCP 注册表，名称为 com.xoomar/xoomar-mcp；在 npm 上的名称为 xoomar-mcp，也收录于 mcpservers.org。

数据条款

重新发布数据时，请注明 XOOMAR，并附上指向 xoomar.com 数据集页面的可见链接，以及结果中的 sourceAttribution 行。数据的使用范围请参阅 https://xoomar.com/terms。

开发

npm install
npm test        # builds, then talks to the server over stdio (one test hits the live API)

此代码采用 Apache-2.0 许可，版权归 XOOMAR 所有。该许可仅适用于代码，不适用于数据。