XOOMAR market data

npx add-mcp 'https://xoomar.com/mcp'

xoomar-mcp

Um servidor MCP que oferece aos agentes de IA a API gratuita de dados de mercado da XOOMAR como ferramentas: 26 ferramentas sobre 31 conjuntos de dados construídos a partir de fontes primárias (SEC EDGAR e XBRL, FINRA, CFTC, o Federal Reserve, USAspending, APIs de exchanges). Nenhuma chave necessária para começar.

Como usar

Hospedado, nada para instalar: https://xoomar.com/mcp (Streamable HTTP). Adicione como servidor MCP remoto ou conector personalizado no Claude.ai, Claude Code (claude mcp add --transport http xoomar https://xoomar.com/mcp), ChatGPT, Cursor ou qualquer cliente que conecte por URL. Envie Authorization: Bearer <key> ou X-API-Key com uma chave de conta gratuita para 30 requisições por minuto; sem uma, o limite é de 10 por minuto por IP. Requisições sem chave ou com chave gratuita retornam até seis meses de histórico.

Local, via stdio: Claude Desktop (claude_desktop_config.json), Claude Code, Cursor, Windsurf e qualquer outro cliente MCP que execute servidores stdio:

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

Claude Code, em uma linha:

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

Como biblioteca (o endpoint hospedado é construído dessa forma):

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

Ambiente opcional para o binário stdio: XOOMAR_API_KEY (uma chave de conta gratuita de https://xoomar.com/signup eleva o limite de 10 para 30 requisições por minuto; requisições sem chave ou com chave gratuita retornam até seis meses de histórico), XOOMAR_MAX_ROWS (linhas por resultado de ferramenta, padrão 200).

Ferramentas

Ferramenta	O que retorna
short_interest	Juros de venda a descoberto da FINRA com dias para cobrir, por data de liquidação
short_volume	Volume diário de vendas a descoberto da FINRA e a participação de vendas a descoberto no volume, desde 2021
fails_to_deliver	Falhas de entrega da SEC por data de liquidação, desde 2010
insider_trades	Transações de insiders do Formulário 4 da SEC
insider_clusters	Empresas onde vários insiders compraram no mercado aberto em um período
threshold_list	Listas de títulos da Reg SHO (Nasdaq e Cboe, desde 2022)
planned_insider_sales	Avisos do Formulário 144 da SEC de venda proposta
large_holders	Detentores dos Anexos 13D e 13G acima de 5%
fund_holders	Quais gestores 13F rastreados detêm um ticker
fund_portfolio	Carteira 13F mais recente de um gestor rastreado
company_financials	Valores trimestrais e anuais e o balanço patrimonial do XBRL
earnings_calendar	Datas de lucros reportadas de arquivamentos 8-K Item 2.02 e a próxima data esperada por empresa (estimada, com sua base)
corporate_events	Eventos materiais 8-K por item
cot_positioning	Compromissos dos Traders da CFTC, mais recente ou histórico de um mercado
funding_rates	Financiamento perpétuo na Binance, Bybit, OKX, Hyperliquid, Kraken e BitMEX
fed_liquidity	Liquidez líquida e seus componentes, ou uma série do FRED
policy_rates	Taxas de política dos bancos centrais, 38 economias com série atual
macro_series	Curva de juros dos EUA, spreads, oferta de stablecoins
treasury_auctions	Resultados e calendário de leilões do Tesouro desde 2010
economic_calendar	22 tipos de divulgações dos EUA a partir dos cronogramas das agências, com valores reais após a divulgação
private_placements	Colocações privadas do Formulário D da SEC
ipo_pipeline	Arquivamentos S-1, F-1, 424B4, EFFECT e RW
bitcoin_treasuries	Bitcoin detido por empresas públicas
federal_contracts	Ações de contratos federais dos EUA por controladora listada
crypto_market	Juros em aberto, liquidações, métricas de opções, posições de baleias
api_reference	Como a API subjacente funciona

Todo resultado traz updatedAt, source e a linha de atribuição. Pergunte coisas como "Como o juro de venda a descoberto da GME se moveu este ano?", "Quais fundos rastreados compraram NVDA no último trimestre?", "O que a liquidez líquida do Fed está fazendo?", "Mostre compras de insiders no mercado aberto nos últimos 7 dias".

Onde está listado

Listado no registro oficial de MCP como com.xoomar/xoomar-mcp e no npm como xoomar-mcp.

Termos de dados

Ao republicar os dados, credite a XOOMAR com um link visível para a página do conjunto de dados em xoomar.com. O que você pode fazer com os dados está definido em https://xoomar.com/terms.

Desenvolvimento

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

Apache-2.0 para este código, XOOMAR. A licença cobre apenas o código, não os dados.