Provides AI agents with access to 26 tools covering SEC filings, insider trades, short interest, and macroeconomic data from primary financial sources.
Also known as xoomar-code/xoomar-mcp, xoomar-mcp
- Stars
- 1
- Tools
- 26
- Downloads, 30 days
- —
- Latest version
- 0.1.11
- Last commit
- Oct 8, 2026
- License
- Apache-2.0
What is XOOMAR market data MCP?
XOOMAR market data provides AI agents with access to 26 tools covering SEC filings, insider trades, short interest, and macroeconomic data from primary financial sources. It exposes 26 tools, such as short_interest, short_volume, fails_to_deliver.
Summary generated from the project's README
About XOOMAR market data MCP server
XOOMAR market data provides AI agents with access to 26 specialized tools covering 31 different datasets. It pulls information from primary financial sources including SEC EDGAR, FINRA, CFTC, the Federal Reserve, and various exchange APIs. Developers can use this as a remote server via a streamable HTTP connection or as a local stdio server using npx. It is compatible with clients like Claude Desktop, Claude Code, Cursor, and Windsurf.
Users can start immediately without an account, though this limits requests to 10 per minute and provides up to six months of history. Registering for a free account with an API key increases the limit to 30 requests per minute. The server includes tools for analyzing insider trades, short interest, company financials from XBRL, and macroeconomic indicators like Fed liquidity or central bank policy rates. It also tracks crypto metrics such as funding rates and open interest across multiple exchanges.
Written from the project's README. Every use case is checked against a quote from it.
How to install XOOMAR market data MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall XOOMAR market data MCP in Claude Code
$ claude mcp add --env 'XOOMAR_API_KEY=<YOUR_XOOMAR_API_KEY>' xoomar-mcp -- npx -y xoomar-mcpInstall XOOMAR market data MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"xoomar-mcp": {
"command": "npx",
"args": [
"-y",
"xoomar-mcp"
],
"env": {
"XOOMAR_API_KEY": "<YOUR_XOOMAR_API_KEY>"
}
}
}
}Install XOOMAR market data MCP in VS Code
.vscode/mcp.json
{
"servers": {
"xoomar-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xoomar-mcp"
],
"env": {
"XOOMAR_API_KEY": "<YOUR_XOOMAR_API_KEY>"
}
}
}
}Install XOOMAR market data MCP in VS Code CLI
$ code --add-mcp '{"name":"xoomar-mcp","type":"stdio","command":"npx","args":["-y","xoomar-mcp"],"env":{"XOOMAR_API_KEY":"<YOUR_XOOMAR_API_KEY>"}}'Install XOOMAR market data MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"xoomar-mcp": {
"command": "npx",
"args": [
"-y",
"xoomar-mcp"
],
"env": {
"XOOMAR_API_KEY": "<YOUR_XOOMAR_API_KEY>"
}
}
}
}Install XOOMAR market data MCP in Codex
$ codex mcp add xoomar-mcp --env 'XOOMAR_API_KEY=<YOUR_XOOMAR_API_KEY>' -- npx -y xoomar-mcpInstall XOOMAR market data MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.xoomar-mcp] command = "npx" args = ["-y", "xoomar-mcp"] [mcp_servers.xoomar-mcp.env] XOOMAR_API_KEY = "<YOUR_XOOMAR_API_KEY>"
Install XOOMAR market data MCP in Gemini CLI
$ gemini mcp add -s user -e 'XOOMAR_API_KEY=<YOUR_XOOMAR_API_KEY>' xoomar-mcp npx -- -y xoomar-mcpInstall XOOMAR market data MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"xoomar-mcp": {
"command": "npx",
"args": [
"-y",
"xoomar-mcp"
],
"env": {
"XOOMAR_API_KEY": "<YOUR_XOOMAR_API_KEY>"
}
}
}
}XOOMAR market data MCP tools 26
Detected from the READMEshort_interestshort_volumefails_to_deliverinsider_tradesinsider_clustersthreshold_listplanned_insider_saleslarge_holdersfund_holdersfund_portfoliocompany_financialsearnings_calendar
| short_interest | — | |
| short_volume | — | |
| fails_to_deliver | — | |
| insider_trades | — | |
| insider_clusters | — | |
| threshold_list | — | |
| planned_insider_sales | — | |
| large_holders | — | |
| fund_holders | — | |
| fund_portfolio | — | |
| company_financials | — | |
| earnings_calendar | — |
Show all 26 toolsShow fewer tools
corporate_eventscot_positioningfunding_ratesfed_liquiditypolicy_ratesmacro_seriestreasury_auctionseconomic_calendarprivate_placementsipo_pipelinebitcoin_treasuriesfederal_contractscrypto_marketapi_reference
| corporate_events | — | |
| cot_positioning | — | |
| funding_rates | — | |
| fed_liquidity | — | |
| policy_rates | — | |
| macro_series | — | |
| treasury_auctions | — | |
| economic_calendar | — | |
| private_placements | — | |
| ipo_pipeline | — | |
| bitcoin_treasuries | — | |
| federal_contracts | — | |
| crypto_market | — | |
| api_reference | — |
Configuration
XOOMAR_API_KEYSecretOptional free account key from https://xoomar.com/signup: 30 requests a minute instead of 10.
XOOMAR_MAX_ROWSRows per tool result (default 200).
| Name | Description | |
|---|---|---|
| XOOMAR_API_KEY | Optional free account key from https://xoomar.com/signup: 30 requests a minute instead of 10. | Secret |
| XOOMAR_MAX_ROWS | Rows per tool result (default 200). |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablexoomar-code/xoomar-mcp is public and reachablegithub.com/xoomar-code/xoomar-mcp ↗Pass
- Package names this repository as its sourcexoomar-mcp names xoomar-code/xoomar-mcp as sourcenpmjs.com/package/xoomar-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-08github.com/xoomar-code/xoomar-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from xoomar-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model26 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 266 msPass
README
View on GitHubxoomar-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
| Tool | What it returns |
|---|---|
short_interest |
FINRA short interest with days to cover, per settlement date |
short_volume |
FINRA daily short sale volume and the short share of volume, since 2021 |
fails_to_deliver |
SEC fails to deliver by settlement date, since 2010 |
insider_trades |
SEC Form 4 insider transactions |
insider_clusters |
Companies where several insiders bought on the open market in a window |
threshold_list |
Reg SHO threshold securities lists (Nasdaq and Cboe, since 2022) |
planned_insider_sales |
SEC Form 144 notices of proposed sale |
large_holders |
Schedule 13D and 13G holders above 5% |
fund_holders |
Which tracked 13F managers hold a ticker |
fund_portfolio |
One tracked manager's latest 13F portfolio |
company_financials |
Quarterly and annual figures and the balance sheet from XBRL |
earnings_calendar |
Reported earnings dates from 8-K Item 2.02 filings and the next expected date per company (estimated, with its basis) |
corporate_events |
8-K material events by item |
cot_positioning |
CFTC Commitments of Traders, latest or one market's history |
funding_rates |
Perpetual funding on Binance, Bybit, OKX, Hyperliquid and Kraken (BitMEX history to 16 Sep 2026, when it closed its swaps) |
fed_liquidity |
Net liquidity and its components, or one FRED series |
policy_rates |
Central bank policy rates, 38 economies with a current series |
macro_series |
US yield curve, spreads, stablecoin supply |
treasury_auctions |
Treasury auction results and calendar since 2010 |
economic_calendar |
22 US release types from the agencies' schedules, with actuals after release |
private_placements |
SEC Form D private placements |
ipo_pipeline |
S-1, F-1, 424B4, EFFECT and RW filings |
bitcoin_treasuries |
Bitcoin held by public companies |
federal_contracts |
US federal contract actions by listed parent |
crypto_market |
Open interest, liquidations, options metrics, whale positions |
api_reference |
How 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.
XOOMAR market data MCP questions
How do I add XOOMAR market data MCP to Claude Code?
Run claude mcp add --env 'XOOMAR_API_KEY=<YOUR_XOOMAR_API_KEY>' xoomar-mcp -- npx -y xoomar-mcp in your terminal. Add --scope user to make it available in every project.
How do I add XOOMAR market data MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does XOOMAR market data MCP provide?
It exposes 26 tools, including short_interest, short_volume, fails_to_deliver, insider_trades, insider_clusters.
How much historical data is available without a key?
Keyless and free-key requests provide up to six months of historical data.
Can I run this server locally?
Yes, you can run it locally over stdio using npx or as a library in TypeScript.