XOOMAR market data

xoomar-mcp

AI エージェントが XOOMAR の無料市場データ API をツールとして利用できる MCP サーバーです。一次情報源（SEC EDGAR と XBRL、FINRA、CFTC、米連邦準備制度、USAspending、取引所 API）に基づく 31 のデータセットを扱う 26 個のツールを提供します。すぐに利用を開始するためのキーは不要です。

使い方

ホスト型、インストール不要： https://xoomar.com/mcp（Streamable HTTP）。Claude.ai、Claude Code（claude mcp add --transport http xoomar https://xoomar.com/mcp）、ChatGPT、Cursor、または URL に接続できる任意のクライアントで、リモート MCP サーバーまたはカスタムコネクターとして追加します。無料アカウントキーを使い、Authorization: Bearer <key> または X-API-Key を送信すると、1 分あたり 30 件のリクエストを利用できます。キーがない場合の上限は IP ごとに 1 分あたり 10 件です。キーなしおよび無料キーでのリクエストでは、最大 6 か月分の履歴が返されます。

ローカル、stdio 経由： Claude Desktop（claude_desktop_config.json）、Claude Code、Cursor、Windsurf、および stdio サーバーを起動するその他の MCP クライアント：

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

Claude Code の場合は、1 行で指定します：

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 で取得できる無料アカウントキーを使うと、リクエスト上限が 1 分あたり 10 件から 30 件に増えます。キーなしおよび無料キーでのリクエストでは、最大 6 か月分の履歴が返されます）、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	追跡対象の運用会社 1 社の最新 13F ポートフォリオ
company_financials	XBRL に基づく四半期および年次の数値と貸借対照表
earnings_calendar	8-K Item 2.02 の届出に記載された発表済み決算日と、企業ごとの次回予想日（根拠付きの推定）
corporate_events	項目別の 8-K 重要イベント
cot_positioning	CFTC の Commitments of Traders。最新情報または特定市場の履歴
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 を買ったのはどこですか？」「Fed の純流動性はどうなっていますか？」「過去 7 日間の公開市場でのインサイダー買い付けを表示してください」といった質問ができます。

掲載先

公式 MCP レジストリには com.xoomar/xoomar-mcp として、npm には xoomar-mcp として、mcpservers.org に掲載されています。

データの利用条件

データを再公開する場合は、結果の sourceAttribution 行とともに、xoomar.com のデータセットページへのリンクを目立つ形で掲載し、XOOMAR をクレジットしてください。データの利用条件は 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。ライセンスの対象はコードのみで、データは対象外です。