Xoomar MCP Server

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 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-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 30 to 120 requests a minute), XOOMAR_MAX_ROWS (rows per tool result, default 200).

Tools

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".

Where it is listed

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.

Data terms

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.

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.