This server is an MCP adapter that gives AI agents access to XOOMAR's free market data API—26 tools across 31 datasets from primary sources, with no key needed to start.
Equities & SEC data: short interest, daily short volume, fails-to-deliver, insider trades (Form 4), Form 144 planned sales, 13D/13G large holders, 13F fund holders/portfolios, XBRL company financials, 8-K corporate events, IPO pipeline, private placements, bitcoin treasuries.
Macro & rates: Fed liquidity and FRED series, central bank policy rates for 49 economies, US yield curve/spreads/stablecoin supply, treasury auctions, US economic calendar.
Derivatives & crypto: CFTC COT positioning, perpetual funding rates, crypto open interest/liquidations/options/whale positions.
Government data: US federal contract actions from USAspending.
Utility: api_reference tool explaining the underlying API, endpoints, rate limits, CSV downloads, and attribution terms.
Access: run locally over stdio via npx, import as a library, or use the hosted Streamable HTTP endpoint at https://xoomar.com/mcp; optional API key raises the rate limit from 30 to 120 requests per minute.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@xoomar-mcp How has GME short interest moved this year?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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 120 requests a minute; without one the limit is 30 a minute per IP.
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-mcpAs 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 transportOptional environment for the stdio bin: XOOMAR_API_KEY (a free account key from https://xoomar.com/signup raises the limit from 30 to 120 requests a minute), XOOMAR_MAX_ROWS (rows per tool result, default 200).
Related MCP server: EdgarMCP
Tool | What it returns |
| FINRA short interest with days to cover, per settlement date |
| FINRA daily short sale volume and the short share of volume, since 2021 |
| SEC fails to deliver by settlement date, since 2010 |
| SEC Form 4 insider transactions |
| Companies where several insiders bought on the open market in a window |
| Reg SHO threshold securities lists (Nasdaq and Cboe, since 2022) |
| SEC Form 144 notices of proposed sale |
| Schedule 13D and 13G holders above 5% |
| Which tracked 13F managers hold a ticker |
| One tracked manager's latest 13F portfolio |
| Quarterly and annual figures and the balance sheet from XBRL |
| Reported earnings dates from 8-K Item 2.02 filings and the next expected date per company (estimated, with its basis) |
| 8-K material events by item |
| CFTC Commitments of Traders, latest or one market's history |
| Perpetual funding on Binance, Bybit, OKX, Hyperliquid, Kraken and BitMEX |
| Net liquidity and its components, or one FRED series |
| Central bank policy rates, 49 economies |
| US yield curve, spreads, stablecoin supply |
| Treasury auction results and calendar since 2010 |
| 22 US release types from the agencies' schedules, with actuals after release |
| SEC Form D private placements |
| S-1, F-1, 424B4, EFFECT and RW filings |
| Bitcoin held by public companies |
| US federal contract actions by listed parent |
| Open interest, liquidations, options metrics, whale positions |
| How the underlying API works |
Every result carries updatedAt, source 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".
Official MCP registry as com.xoomar/xoomar-mcp (server.json in this repository is what gets published: the npm package and the hosted https://xoomar.com/mcp remote), npm as xoomar-mcp, and on Glama. The mcpName field in package.json is the registry's proof that the npm package and the registry entry belong together.
When you republish the data, credit XOOMAR with a visible link to the dataset page on xoomar.com. What you may do with the data is set out at 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 for this code, XOOMAR. The license covers the code only, not the data.
How the underlying free API works: endpoints, parameters, rate limits, CSV downloads and the attribution terms. Use when a tool here does not cover the exact query.
Inputs: no named parameters.
Bitcoin holdings of public companies from their own XBRL filings: coins, fair value, cost basis, as of the filing period.
Inputs: no named parameters.
Quarterly revenue, net income and diluted EPS (calendar quarters, fourth quarter derived from the annual report), annual revenue, net income, operating cash flow, capex, buybacks and dividends, and the latest balance sheet instants, from the company's own XBRL filings.
Inputs: symbol (required).
8-K current reports with their item numbers (2.02 earnings, 5.02 officer changes, 1.01 agreements and so on), for a ticker or the latest across companies.
Inputs: days, item, ticker.
Weekly CFTC positioning: the latest report across all tracked markets, or one market's history (e.g. gold, crude-oil, sp500, bitcoin, euro-fx, 10-year-note): open interest and long/short by trader category.
Inputs: limit, market.
Open interest history for a symbol slug, recent liquidations across exchanges, Deribit options metrics (put/call, max pain, DVOL) for BTC or ETH, or Hyperliquid whale positions.
Inputs: dataset (required), slug.
Scheduled US releases (CPI, NFP, FOMC, GDP and more) with consensus and actuals once published.
Inputs: to, from, importance.
SEC fails-to-deliver quantity and price by settlement date for a symbol, or the latest settlement's largest fails by value.
Inputs: symbol.
Largest US federal contract actions from USAspending, optionally summed by listed parent company (by=ticker) or filtered to one ticker.
Inputs: by, days, listed, ticker.
Weekly US net liquidity (Fed balance sheet minus the Treasury General Account minus reverse repo) with its components, oldest first, or one FRED series (WALCL, WRESBAL, RRPONTSYD, WTREGEN, SOFR, EFFR, IORB, WSHOSHO).
Inputs: limit, series.
Which tracked 13F managers (Berkshire, Bridgewater, Citadel, Renaissance and others) held a ticker at their latest quarterly filing: shares, value, share of portfolio, change.
Inputs: ticker (required).
Current perpetual funding rates on Binance, Bybit and OKX for tracked crypto symbols, or one symbol's history by slug (e.g. btc, eth, sol).
Inputs: slug.
The latest 13F portfolio of one tracked manager by slug, e.g. berkshire-hathaway, bridgewater, citadel-advisors, renaissance-technologies. Positions with value, shares and share of portfolio.
Inputs: slug (required).
Insider transactions from SEC Form 4: insider name and title, transaction code, shares, price, value, date. History for a ticker or the latest trades across companies (type P for open-market purchases, S for sales).
Inputs: type, ticker, window.
S-1 and F-1 registration statements, 424B4 final prospectuses, EFFECT notices and RW withdrawals from EDGAR, with the filer's listing status.
Inputs: new, days, form.
Holders above 5% from Schedule 13D (active) and 13G (passive) cover pages: holder, shares, percent of class, filing date. For a symbol or the latest filings.
Inputs: days, form, sort, symbol.
US Treasury yield curve points, curve spreads and stablecoin supply as daily series. Filter by series name and date range.
Inputs: to, from, series.
Form 144 notices: an affiliate's planned sale of restricted or control stock (seller, shares, approximate market value, planned date), filed before the trade.
Inputs: days, symbol.
Policy rates for 49 economies: the current table, or one country code's history (e.g. us, eu, jp, gb).
Inputs: country.
Form D notices of exempt offerings: issuer, amount sold, amount offered, investors, whether it is a pooled fund. Largest raises in a window, one issuer by CIK, or the most recent filings.
Inputs: cik, days, sort, funds.
Short interest for a US stock: shares short, average daily volume, days to cover, change, per FINRA settlement date (twice a month), newest first. Without a symbol: the latest settlement's highest days-to-cover names.
Inputs: limit, symbol.
Daily short sale volume and total volume per symbol from FINRA's Reg SHO files, with the short share of volume. History for a symbol (oldest first) or the latest day's largest short volumes.
Inputs: days, symbol.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 22 tools
Most tools map to clearly distinct datasets (13F portfolios, short interest, short volume, fails-to-deliver, Form 4, Form 144, 13D/G, 8-K, COT, funding rates, etc.). A few pairs are adjacent and could be misselected, notably short_interest vs short_volume and fund_portfolio vs fund_holders, but the descriptions differentiate direction and data source.
Every tool uses lowercase snake_case and a consistent topic/noun-phrase convention (fund_portfolio, short_interest, insider_trades, policy_rates). No mixing of camelCase, verbs, or stray styles.
22 tools is on the heavy side but justified by the server's breadth of independent financial data sources, each covering a different dataset. No obvious filler tools, though the count is at the upper bound of comfortable.
The surface covers an unusually broad set of read-only datasets across equities, funds, macro, crypto and government data, and includes an api_reference escape hatch for uncovered queries. Minor gaps remain (e.g. options/equity derivatives, ETF holdings, deeper estimate history), but core domains are well covered.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
US stock market data for AI agents: SEC filings, financials, insider trades, 13F, options, macro.
SEC EDGAR financials, insider trading, and economic data for AI agents. US GAAP + IFRS.
US government data as clean JSON for AI agents: SAM.gov contract opportunities, USAspending awards, Grants.gov grants, House STOCK Act trades, and SEC EDGAR filings (Form 4 insider trades, 8-K events, 13F holdings, 13D/G stakes, XBRL fundamentals, 10-K/10-Q sections). 19 read-only tools. Data is as fresh as each source publishes; congressional trades lag up to 45 days and report dollar ranges (House only). Free tier, no card.
