English Français العربية

XOOMAR market data

Registre officiel Autres

Free US market data as tools: SEC filings, insiders, short interest, 13F, COT, Fed liquidity.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http xoomar-market-data 'https://xoomar.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xoomar-market-data": {
            "type": "http",
            "url": "https://xoomar.com/mcp"
        }
    }
}
NPM package xoomar-mcp
Claude Code 
claude mcp add xoomar-market-data -e 'XOOMAR_API_KEY=<your xoomar_api_key>' -e 'XOOMAR_MAX_ROWS=200' -- npx -y xoomar-mcp@0.1.11
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xoomar-market-data": {
            "command": "npx",
            "args": [
                "-y",
                "xoomar-mcp@0.1.11"
            ],
            "env": {
                "XOOMAR_API_KEY": "<your xoomar_api_key>",
                "XOOMAR_MAX_ROWS": "200"
            }
        }
    }
}

Variables d'environnement

  • XOOMAR_API_KEY secret Optional free account key from https://xoomar.com/signup: 30 requests a minute instead of 10.
  • XOOMAR_MAX_ROWS Rows per tool result (default 200).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. xoomar-mcp
  2. Use it
  3. Tools
  4. Where it is listed
  5. Data terms
  6. Development

xoomar-mcp

An MCP server that gives AI agents the XOOMAR free market data API as tools: 26 tools over 31 datasets built from primary sources (SEC EDGAR and XBRL, FINRA, CFTC, the Federal Reserve, USAspending, exchange APIs). No key needed to start.

Use it

Hosted, nothing to install: https://xoomar.com/mcp (Streamable HTTP). Add it as a remote MCP server or custom connector in Claude.ai, Claude Code (claude mcp add --transport http xoomar https://xoomar.com/mcp), ChatGPT, Cursor or any client that connects by URL. Send Authorization: Bearer <key> or X-API-Key with a free account key for 30 requests a minute; without one the limit is 10 a minute per IP. Keyless and free-key requests return up to six months of history.

Local, over stdio: Claude Desktop (claude_desktop_config.json), Claude Code, Cursor, Windsurf and any other MCP client that launches stdio servers:

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

Claude Code, one line:

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

As a library (the hosted endpoint is built this way):

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

Optional environment for the stdio bin: XOOMAR_API_KEY (a free account key from https://xoomar.com/signup raises the limit from 10 to 30 requests a minute; keyless and free-key requests return up to six months of history), XOOMAR_MAX_ROWS (rows per tool result, default 200).

Tools

ToolWhat it returns
short_interestFINRA short interest with days to cover, per settlement date
short_volumeFINRA daily short sale volume and the short share of volume, since 2021
fails_to_deliverSEC fails to deliver by settlement date, since 2010
insider_tradesSEC Form 4 insider transactions
insider_clustersCompanies where several insiders bought on the open market in a window
threshold_listReg SHO threshold securities lists (Nasdaq and Cboe, since 2022)
planned_insider_salesSEC Form 144 notices of proposed sale
large_holdersSchedule 13D and 13G holders above 5%
fund_holdersWhich tracked 13F managers hold a ticker
fund_portfolioOne tracked manager's latest 13F portfolio
company_financialsQuarterly and annual figures and the balance sheet from XBRL
earnings_calendarReported earnings dates from 8-K Item 2.02 filings and the next expected date per company (estimated, with its basis)
corporate_events8-K material events by item
cot_positioningCFTC Commitments of Traders, latest or one market's history
funding_ratesPerpetual funding on Binance, Bybit, OKX, Hyperliquid and Kraken (BitMEX history to 16 Sep 2026, when it closed its swaps)
fed_liquidityNet liquidity and its components, or one FRED series
policy_ratesCentral bank policy rates, 38 economies with a current series
macro_seriesUS yield curve, spreads, stablecoin supply
treasury_auctionsTreasury auction results and calendar since 2010
economic_calendar22 US release types from the agencies' schedules, with actuals after release
private_placementsSEC Form D private placements
ipo_pipelineS-1, F-1, 424B4, EFFECT and RW filings
bitcoin_treasuriesBitcoin held by public companies
federal_contractsUS federal contract actions by listed parent
crypto_marketOpen interest, liquidations, options metrics, whale positions
api_referenceHow the underlying API works

Every result carries updatedAt, source (who publishes the data: FINRA, the SEC, the CFTC, the exchange), sourceAttribution (the credit line to show with it) and the attribution line. Ask things like "How has GME short interest moved this year?", "Which tracked funds bought NVDA last quarter?", "What is Fed net liquidity doing?", "Show open-market insider purchases in the last 7 days".

Where it is listed

Listed in the official MCP registry as com.xoomar/xoomar-mcp, on npm as xoomar-mcp, and on mcpservers.org.

Data terms

When you republish the data, credit XOOMAR with a visible link to the dataset page on xoomar.com, together with the result's sourceAttribution line. What you may do with the data is set out at https://xoomar.com/terms.

Development

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

Apache-2.0 for this code, XOOMAR. The license covers the code only, not the data.

Questions fréquentes

Qu'est-ce que XOOMAR market data ?

Free US market data as tools: SEC filings, insiders, short interest, 13F, COT, Fed liquidity.

Comment installer XOOMAR market data ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http xoomar-market-data 'https://xoomar.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour XOOMAR market data ?

Oui. Il attend XOOMAR_API_KEY, à renseigner dans sa configuration.

XOOMAR market data est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient XOOMAR market data ?

Il est publié par xoomar-code. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.