# XOOMAR market data

Hands your agent 26 tools for US market data: SEC filings, insider activity, short interest, 13F, COT and Fed liquidity. No key required to start.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: xoomar-code
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/xoomar-code/xoomar-mcp
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/mcp/xoomar-market-data

## What it does

Two ways in. The hosted endpoint at `https://xoomar.com/mcp` speaks Streamable HTTP; the same tool set runs locally over stdio with `npx -y xoomar-mcp`. Behind it sit 26 tools drawing on 31 datasets assembled from primary sources — SEC EDGAR and XBRL, FINRA, CFTC, the Federal Reserve, USAspending and exchange APIs.

Keyless access allows 10 requests a minute per IP; a free account key raises that to 30. Either way the history you get back stops at six months. `XOOMAR_MAX_ROWS` controls how many rows a tool returns, 200 by default. Every result carries `updatedAt`, `source` and a `sourceAttribution` line you are expected to display when republishing, along with a link to the dataset page on xoomar.com.

Apache-2.0 covers the code, not the data. The terms on xoomar.com spell out what you may do with it, so read them before you build a report on top.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://xoomar.com/mcp`
- Environment variables: `XOOMAR_API_KEY`, `XOOMAR_MAX_ROWS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http xoomar-mcp https://xoomar.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env XOOMAR_API_KEY=<XOOMAR_API_KEY> --env XOOMAR_MAX_ROWS=<XOOMAR_MAX_ROWS> --transport stdio xoomar-market-data -- npx -y xoomar-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add xoomar-market-data --url https://xoomar.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add xoomar-market-data --env XOOMAR_API_KEY=<XOOMAR_API_KEY> --env XOOMAR_MAX_ROWS=<XOOMAR_MAX_ROWS> -- npx -y xoomar-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xoomar-market-data": {
            "url": "https://xoomar.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "xoomar-market-data": {
            "command": "npx",
            "args": [
                "-y",
                "xoomar-mcp"
            ],
            "env": {
                "XOOMAR_API_KEY": "<XOOMAR_API_KEY>",
                "XOOMAR_MAX_ROWS": "<XOOMAR_MAX_ROWS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xoomar-market-data": {
            "type": "http",
            "url": "https://xoomar.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "xoomar-market-data": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "xoomar-mcp"
            ],
            "env": {
                "XOOMAR_API_KEY": "<XOOMAR_API_KEY>",
                "XOOMAR_MAX_ROWS": "<XOOMAR_MAX_ROWS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http xoomar-market-data https://xoomar.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e XOOMAR_API_KEY=<XOOMAR_API_KEY> -e XOOMAR_MAX_ROWS=<XOOMAR_MAX_ROWS> xoomar-market-data npx -y xoomar-mcp
```
Replace <…> with your own values

## When to use it
- check short interest on a ticker with days to cover
- spot companies where multiple insiders bought on the open market
- see which tracked 13F managers hold a stock
- pull quarterly and annual figures from XBRL
- track Fed net liquidity and its components

## Example prompts
- How has GME short interest moved this year?
- What is Fed net liquidity doing right now?

## Similar
- [market-data](https://affpapa.org/en/nevibecode/skills/rebyteai-template-market-data.md) — skill · 380 installs
- [TickDB Market Data](https://affpapa.org/en/nevibecode/mcp/tickdb-market-data.md) — MCP server · ★ 893
- [FactIQ](https://affpapa.org/en/nevibecode/mcp/factiq.md) — MCP server · ★ 19
- [longbridge-market-data](https://affpapa.org/en/nevibecode/skills/longbridge-market-data.md) — skill · 3300 installs
- [llmquant-data](https://affpapa.org/en/nevibecode/skills/llmquant-data.md) — skill · 511 installs
- [0xArchive Market Data](https://affpapa.org/en/nevibecode/mcp/0xarchive-market-data.md) — MCP server · ★ 13

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md