Equibles
Mercado de ações dos EUA e dados financeiros — busca em texto completo de arquivos da SEC, fundamentos XBRL, participações institucionais 13F, negociações de insiders e do congresso, transcrições de teleconferências de resultados, juros curtos e macro FRED; mais de 90 ferramentas, nível gratuito, auto-hospedável.
Documentação
Equibles — Servidor MCP de Dados Financeiros e do Mercado de Ações
111 ferramentas MCP para agentes de IA como Claude, ChatGPT e Cursor: arquivos SEC, fundamentos, participações institucionais 13F, negociações de insiders e congressistas, transcrições de teleconferências de resultados, cadeias de opções, cotações em tempo real, arquivos de IPO, juros sobre vendas a descoberto, dados macroeconômicos e seu próprio portfólio. Camada hospedada gratuita, ou auto-hospedagem da stack de código aberto.
O que é isso?
O Model Context Protocol (MCP) permite que assistentes de IA chamem ferramentas de dados externas em vez de adivinhar a partir dos dados de treinamento. A Equibles expõe dados financeiros e do mercado de ações dos EUA como um servidor MCP: use-o hospedado em https://mcp.equibles.com/mcp (chave de API gratuita, ou OAuth sem chave alguma), ou execute-o você mesmo a partir da stack de código aberto. Tudo é extraído das fontes primárias (SEC EDGAR, FINRA, FRED, CFTC, CBOE, USAspending, sites de RI das empresas), não de estimativas de terceiros.
Início rápido (hospedado, 30 segundos)
- Crie uma conta gratuita em equibles.com — não é necessário cartão de crédito.
- Crie uma chave de API em
https://equibles.com/dashboard/apikeys. Ela começa comeq_e é exibida apenas uma vez, então copie-a imediatamente. - Conecte seu cliente com a URL
https://mcp.equibles.com/mcp(veja abaixo).
ChatGPT e Claude (web e Desktop) podem pular a chave completamente e entrar via OAuth.
Conecte seu cliente de IA
Claude Desktop / Claude web (claude.ai)
Configurações → Conectores → Adicionar conector personalizado → URL https://mcp.equibles.com/mcp → entre via OAuth (sem necessidade de chave).
Alternativa com chave: use a URL https://mcp.equibles.com/mcp?api_key=eq_your_api_key.
Claude Code
claude mcp add --transport http equibles https://mcp.equibles.com/mcp
Em seguida, execute /mcp e escolha Autenticar para entrar via OAuth.
Alternativa com chave:
claude mcp add-json equibles '{"type":"http","url":"https://mcp.equibles.com/mcp","headers":{"Authorization":"Bearer eq_your_api_key"}}' --scope user
ChatGPT
Adicione um conector em modo de desenvolvedor com a URL https://mcp.equibles.com/mcp e conclua o login via OAuth (ou use a URL ?api_key=eq_your_api_key).
Cursor
Adicione em ~/.cursor/mcp.json:
{ "mcpServers": { "equibles": { "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }
VS Code (Copilot)
code --add-mcp '{"name":"equibles","type":"http","url":"https://mcp.equibles.com/mcp"}'
Ou adicione um .vscode/mcp.json com um objeto "servers" usando a mesma URL e a estrutura de cabeçalho Authorization:
{ "servers": { "equibles": { "type": "http", "url": "https://mcp.equibles.com/mcp", "headers": { "Authorization": "Bearer eq_your_api_key" } } } }
Qualquer cliente MCP
Use o transporte HTTP com a URL https://mcp.equibles.com/mcp, autenticando com um cabeçalho Authorization: Bearer eq_... ou um parâmetro de consulta ?api_key=eq_....
Após conectar, veja os guias completos por cliente em https://equibles.com/docs/mcp.
Exemplos de prompts
- "Quais fundos de hedge compraram mais NVIDIA no último trimestre?"
- "Resuma os fatores de risco no 10-K mais recente da Tesla."
- "Mostre vendas recentes de insiders na Microsoft, e algum membro do Congresso negociou essa ação este ano?"
- "O que a NVIDIA projetou para o próximo trimestre e quais KPIs ela reportou?"
- "Quais ações têm as maiores pontuações de short squeeze hoje?"
- "Filtre ações de software lucrativas com P/L abaixo de 20."
- "Qual é o IPCA mais recente e a taxa de desemprego?"
Ferramentas
111 ferramentas, agrupadas por conjunto de dados.
Pesquisa de arquivos SEC e RAG de texto completo
| Ferramenta | Descrição |
|---|---|
| SearchDocuments | Pesquisa híbrida por palavras-chave + semântica em todos os arquivos SEC das empresas. |
| SearchCompanyDocuments | Pesquisa híbrida dos arquivos de uma empresa por ticker. |
| SearchDocument | Pesquisa híbrida dentro de um único arquivo. |
| ListCompanyDocuments | Navegue pelos arquivos SEC e transcrições disponíveis de uma empresa. |
| SearchDocumentKeyword | Pesquisa por palavra-chave dentro de um arquivo. |
| ReadDocumentLines | Leia um intervalo de linhas de um arquivo. |
Demonstrações financeiras e fundamentos (XBRL)
| Ferramenta | Descrição |
|---|---|
| GetFinancialStatement | Demonstração de resultados, balanço patrimonial ou fluxo de caixa para um período fiscal (XBRL). |
| GetFinancialFact | Um conceito financeiro ao longo do tempo. |
| CompareFinancialFact | Compare um conceito entre empresas. |
| GetRevenueBreakdown | Receita por segmento, geografia e produto (XBRL dimensional). |
Participações institucionais 13F e portfólios de fundos de hedge
| Ferramenta | Descrição |
|---|---|
| GetFundCloneBacktest | Backtest de clonagem do portfólio 13F de um declarante institucional versus um benchmark de mercado. |
| GetTopHolders | Principais detentores institucionais de uma ação a partir de arquivos 13F-HR da SEC, classificados por ações detidas. |
| GetOwnershipHistory | Tendência histórica da participação institucional ao longo dos trimestres. |
| GetInstitutionPortfolio | O portfólio de uma instituição específica a partir de seu 13F-HR. |
| SearchInstitutions | Pesquise investidores institucionais por nome ou CIK da SEC. |
| GetTopBuyersSellers | Instituições com os maiores aumentos/reduções de posição em uma ação neste trimestre. |
| GetMarketWide13FActivity | Rankings 13F de todo o mercado (maiores compras/vendas/novas/vendidas) para um trimestre. |
| GetMostHeldStocks | Ações classificadas pela amplitude institucional 13F. |
| GetInstitutionSummary | Resumo do portfólio de um declarante 13F (valor, concentração, rotatividade). |
| GetInstitutionSectorAllocation | Alocação 13F de uma instituição por setor. |
| GetInstitutionQuarterlyActivity | Atividade iniciada / aumentada / reduzida / encerrada versus o trimestre anterior. |
| GetFundOverlap | Sobreposição de portfólios 13F entre duas instituições. |
| GetConsensusHoldings | Portfólio de consenso de 2 a 25 instituições. |
Negociação de insiders (Formulários 3/4/5 e Formulário 144)
| Ferramenta | Descrição |
|---|---|
| GetInsiderTransactions | Transações recentes de insiders a partir dos Formulários 3/4/5 da SEC. |
| GetInsiderOwnership | Resumo da participação de insiders, classificado por ações detidas. |
| GetProposedSales | Vendas propostas por insiders a partir do Formulário 144 da SEC. |
| SearchInsiders | Pesquise insiders corporativos por nome. |
| GetInsiderSentimentScores | Ações com as maiores pontuações compostas de sentimento de insiders (0–100). |
Negociação de ações por congressistas
| Ferramenta | Descrição |
|---|---|
| GetCongressionalTrades | Negociações de congressistas para um ticker. |
| GetMemberTrades | Negociações divulgadas de um membro. |
| GetMemberNetWorth | Histórico de patrimônio líquido de um membro a partir de divulgações. |
| SearchCongressMembers | Pesquise membros por nome. |
| GetMarketWideCongressionalActivity | Ações mais negociadas pelo Congresso em uma janela recente. |
Teleconferências de resultados: transcrições, resumos e insights de IA
| Ferramenta | Descrição |
|---|---|
| GetEarningsCallEvent | O evento de teleconferência de resultados para um trimestre fiscal. |
| ListInvestorEvents | Eventos recentes de investidores. |
| GetInvestorEventSpeakers | Transcrição com identificação de falantes por ID de evento. |
| GetEarningsCallSpeakers | Transcrição da teleconferência de resultados com identificação de falantes por trimestre fiscal. |
| GetEarningsBrief | Resumo de IA da teleconferência (TL;DR, pontos positivos/negativos, citações de destaque). |
| GetCallInsights | Insights pontuados por IA (tom, hedging, temas). |
| GetInvestorEventSlides | Apresentação de slides capturada do evento de investidores: título, fonte, número de páginas e links para o PDF ou imagens dos slides. |
Projeções de resultados, KPIs e reconciliações não-GAAP
| Ferramenta | Descrição |
|---|---|
| GetGuidance | Projeções de resultados a partir de 8-Ks e transcrições de teleconferências. |
| GetCompanyKpis | KPIs específicos da empresa (assinantes, ARR, EBITDA ajustado…). |
| GetNonGaapBridge | Reconciliações não-GAAP para GAAP. |
Preços de ações e indicadores técnicos
| Ferramenta | Descrição |
|---|---|
| GetStockPrices | Histórico diário de OHLCV (ajustado por desdobramentos). |
| GetLatestPrices | Fechamento mais recente, variação e volume. |
| GetStochasticOscillator | Série do oscilador estocástico. |
| GetAverageTrueRange | Série do average true range (ATR). |
| GetOnBalanceVolume | Série do on-balance-volume (OBV). |
| GetBollingerBands | Série das Bandas de Bollinger. |
Juros sobre vendas a descoberto, volume a descoberto e dark pools (FINRA)
| Ferramenta | Descrição |
|---|---|
| GetShortVolume | Volume diário de vendas a descoberto (FINRA). |
| GetShortInterest | Juros sobre vendas a descoberto quinzenais. |
| GetShortInterestSnapshot | Instantâneo de liquidação mais recente de todo o mercado. |
| GetLargestShortVolume | Maior volume diário de vendas a descoberto. |
| GetShortSqueezeScores | Maiores pontuações compostas de short squeeze (0–100). |
| GetOffExchangeVolume | Volume semanal de dark pools / OTC (FINRA ATS). |
Cotações em tempo real e cadeias de opções
| Ferramenta | Descrição |
|---|---|
| GetLiveQuote | Preço intradiário mais recente para uma ou mais listagens dos EUA. |
| GetOptionExpirations | Datas de vencimento de opções disponíveis para uma ação, com a contagem de contratos em cada uma. |
| GetOptionChain | Calls e puts para um vencimento: strike, bid/ask, volume, open interest, IV e gregas. |
| GetOptionContract | Instantâneo completo de um contrato de opção pelo seu símbolo OCC. |
Pipeline de IPOs (S-1 / F-1)
| Ferramenta | Descrição |
|---|---|
| GetIpoFeed | O pipeline de registro S-1/F-1 dos EUA, com a atividade de arquivamento mais recente primeiro. |
| GetIpoDetails | Um registro completo: status, termos da oferta, subscritores, fatores de risco e finanças pré-IPO. |
Múltiplos de valuation e filtro de ações
| Ferramenta | Descrição |
|---|---|
| GetValuationMultiples | EV/Receita, EV/EBIT, P/L com quartis do setor. |
| GetValuationMultiplesHistory | Os mesmos múltiplos de valuation ao longo do tempo. |
| ScreenStocks | Filtre o universo de ações com filtros de faixa em vários conjuntos de dados. |
| GetCorrelatedStocks | Ações mais e menos correlacionadas por retornos diários. |
Dados econômicos (FRED) e calendário macroeconômico
| Ferramenta | Descrição |
|---|---|
| GetEconomicIndicator | Série temporal para um indicador FRED (~40 séries selecionadas). |
| GetLatestEconomicData | Valores mais recentes em todas as categorias. |
| SearchEconomicIndicators | Pesquise as séries selecionadas. |
| GetEconomicCalendar | Divulgações macroeconômicas dos EUA agendadas e recentes. |
Posicionamento de futuros (CFTC COT)
| Ferramenta | Descrição |
|---|---|
| GetCftcPositioning | Posicionamento COT para um contrato futuro. |
| GetLatestCftcData | Instantâneo COT mais recente em ~35 contratos monitorados. |
| SearchCftcMarkets | Pesquise contratos CFTC monitorados. |
Volatilidade e sentimento de opções (CBOE)
| Ferramenta | Descrição |
|---|---|
| GetPutCallRatios | Índices put/call da CBOE (Total / Ações / Índice / Vix / Etp). |
| GetVixHistory | Histórico diário de OHLC do VIX. |
Fundos, ETFs e consultores de investimento
| Ferramenta | Descrição |
|---|---|
| SearchInvestmentAdvisers | Pesquise consultores de investimento registrados na SEC (Formulário ADV). |
| GetInvestmentAdviser | Perfil completo do Formulário ADV por número CRD. |
| GetFundOperations | Dados operacionais de fundos do Formulário N-CEN. |
| GetFundHoldings | Participações de portfólio de fundos/ETFs do NPORT-P mais recente. |
| GetFundsHoldingStock | Fundos/ETFs que detêm uma determinada ação. |
| GetExemptOfferings | Colocações privadas do Formulário D. |
| GetFailsToDeliver | Dados de FTD dos arquivos quinzenais da SEC. |
| SearchFunds | Pesquise fundos/ETFs registrados. |
| GetFundProfile | Perfil do fundo e maiores participações do NPORT-P. |
Composição de índices e previsões
| Ferramenta | Descrição |
|---|---|
| GetIndexComposition | Lista atual de constituintes de um índice, com os mais pesados primeiro, incluindo o peso de cada empresa. |
| GetIndexChanges | Empresas que entraram ou saíram de um índice, com as mais recentes primeiro, e as datas que delimitam cada mudança. |
| GetIndexForecast | Aplica as regras de entrada publicadas de um índice a todas as empresas que monitoramos, regra por regra. |
Eventos corporativos e governança
| Ferramenta | Descrição |
|---|---|
| GetExecutiveChanges | Mudanças de executivos/diretores a partir do Item 5.02 do 8-K. |
| GetExecutiveCompensation | Remuneração do DEF 14A. |
| GetBuybackPrograms | Programas de recompra de ações e histórico. |
| GetAtmPrograms | Programas de oferta de ações at-the-market. |
| GetGoingConcernStatus | Status de dúvida sobre continuidade operacional do arquivo mais recente. |
| GetCustomerConcentration | Divulgações de risco de concentração de clientes. |
| GetInvestorRelationsNews | Comunicados de imprensa recentes de RI. |
| GetInvestorRelationsEvents | Próximos eventos/webcasts de RI. |
| GetSuperInvestors | Diretório selecionado de superinvestidores com CIKs 13F. |
| GetGovernmentContracts | Prêmios de contratos federais (USAspending.gov) vencidos por uma empresa. |
| GetTopGovernmentContractors | Empresas classificadas por dólares de contratos federais. |
| GetFdaCatalysts | Reuniões agendadas do comitê consultivo da FDA. |
| GetMarketStatus | Status da sessão do mercado dos EUA. |
| GetMarketCalendar | Feriados de mercado e meios dias. |
Seu próprio portfólio (as únicas ferramentas que escrevem)
Escopo limitado à conta por trás da chave de API. As participações do próprio chamador, nunca as de terceiros.
| Ferramenta | Descrição |
|---|---|
| GetMyPortfolio | As participações salvas do usuário, precificadas, com custo base e lucro realizado/não realizado. |
| CreateMyPortfolio | Criar um novo portfólio vazio. |
| DeleteMyPortfolio | Excluir permanentemente um portfólio e todos os lotes nele. |
| AddPortfolioLot | Registrar uma compra ou venda como um lote, para uma ação ou contrato de opção. |
| UpdatePortfolioLot | Corrigir a quantidade, o preço, a data de negociação ou a nota de um lote. |
| ClosePortfolioLot | Registrar uma venda, cobertura ou expiração de todo ou parte de um lote, mantendo seu lucro realizado. |
| RemovePortfolioLot | Excluir permanentemente um lote inserido por engano. |
| WatchInstrument | Colocar uma ação ou contrato de opção em uma lista de observação, sem registrar posição. |
| UnwatchInstrument | Remover uma ação ou contrato de opção de uma lista de observação. |
Feedback do agente
| Ferramenta | Descrição |
|---|---|
| ReportProblem | Relatar dados errados, ausentes ou quebrados diretamente da chamada da ferramenta. |
| SuggestToolImprovement | Sugerir uma mudança no comportamento, argumentos ou saída de uma ferramenta. |
Preços e limites de taxa
| Plano | Solicitações diárias | Preço | Cartão necessário |
|---|---|---|---|
| Grátis | 100 solicitações/dia | $0 | Não |
| Pro | 10.000 solicitações/dia | Veja preços | Sim |
- Um contador diário compartilhado entre o servidor MCP e a API REST; ele é redefinido às 00:00 UTC.
- Os cabeçalhos de limite de taxa são expostos nas respostas:
X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-ReseteRetry-After(em 429). - Quando você excede o limite, o servidor MCP responde em banda com um resultado de ferramenta normal explicando o limite, em vez de retornar um erro opaco, para que seu agente possa ler e reagir a ele.
Detalhes em https://equibles.com/pricing.
Self-host com Docker (código aberto)
A pilha completa é de código aberto em https://github.com/daniel3303/Equibles.
git clone https://github.com/daniel3303/Equibles
cd Equibles
docker compose up
O servidor MCP sobe em http://localhost:8081/mcp. Nenhuma chave de API é necessária por padrão; defina a variável de ambiente MCP_API_KEY para exigir um cabeçalho Authorization: Bearer <key>. Ao fazer self-hosting, o cabeçalho Bearer é o único método de autenticação (sem parâmetro de consulta, sem OAuth).
O servidor self-hosted expõe o subconjunto de código aberto com 64 ferramentas: participações 13F, negociações de insiders, arquivamentos e fundamentos da SEC, fundos/ETFs/consultores, FRED, CFTC, CBOE, negociações do Congresso, dados de vendas a descoberto, preços de ações, contratos do governo e o calendário da FDA. O servidor hospedado adiciona mais 44: chamadas de lucros, orientações, KPIs, o screener, múltiplos de avaliação, recompra de ações, dados executivos, cotações ao vivo, cadeias de opções, arquivamentos de IPO e seu próprio portfólio.
Nota: a pilha self-hosted executa seus próprios scrapers contra as fontes primárias, então os bancos de dados começam vazios e se preenchem ao longo do tempo após você iniciá-la.
API REST
Tudo também está disponível como uma API REST convencional em https://api.equibles.com/v1, compartilhando a mesma chave de API e limite diário do servidor MCP. Documentação em https://equibles.com/docs.
Fontes de dados e metodologia
Cada conjunto de dados é analisado a partir da fonte primária, nunca de estimativas de terceiros:
- SEC EDGAR — arquivamentos, fundamentos XBRL, participações 13F, Formulários 3/4/5/144, NPORT, ADV, N-CEN, Formulário D
- FINRA — volume de vendas a descoberto, juros de vendas a descoberto, volume de dark-pool / fora de bolsa
- FRED — indicadores econômicos e séries macro
- CFTC — posicionamento de futuros Commitments of Traders
- CBOE — índices put/call e VIX
- USAspending.gov — contratos de governo federal
- Sites de RI de empresas — notícias e eventos de relações com investidores
- Divulgações do Congresso — negociações e patrimônio líquido de membros
Detalhes da metodologia em https://equibles.com/docs/methodology.
Links
- Site: https://equibles.com
- Documentação: https://equibles.com/docs
- Criar uma chave de API: https://equibles.com/dashboard/apikeys
- Pilha de código aberto: https://github.com/daniel3303/Equibles
- Preços: https://equibles.com/pricing