Eugene Intelligence

Dados financeiros para agentes de IA. Fundamentos SEC XBRL, negociações de insiders, participações 13F, rendimentos de títulos públicos. Com rastreamento de fonte.

GitHub

Experimente este MCPPatrocinado

Documentação

Eugene Intelligence v0.8

Infraestrutura de dados financeiros para agentes de IA. Cada número rastreado até a fonte.

A primeira plataforma de dados financeiros nativa do MCP. Uma única chamada de ferramenta fornece demonstrações financeiras da SEC normalizadas, mais de 50 índices calculados, preços em tempo real, indicadores técnicos, criptomoedas e dados macro — tudo com rastreamento completo de proveniência. Construída com HTTP assíncrono, cache persistente em disco e tratamento abrangente de erros.

Início Rápido

pip install -e .

# Three ways to run
eugene caps                        # CLI — list all capabilities
python eugene_server.py            # REST API + MCP on port 8000
python eugene_server.py --mode mcp # MCP stdio server (for Claude Desktop)

O Que Você Pode Fazer

# SEC fundamentals with clean IS/BS/CF grouping
eugene sec AAPL -e financials -l 5

# 50+ financial ratios (PE, ROE, margins, leverage, growth)
eugene sec AAPL -e metrics

# Technical indicators (SMA, EMA, RSI, MACD, Bollinger, ATR, VWAP)
eugene sec AAPL -e technicals

# Daily price bars
eugene ohlcv AAPL -i daily --from 2026-01-01 --to 2026-03-14

# Live crypto quotes
eugene crypto BTCUSD

# Corporate actions (dividends + splits + 8-K events merged)
eugene sec AAPL -e corporate_actions

# Download as CSV
eugene export AAPL -f csv

# Stock screening
eugene screener --sector Technology --market-cap-min 1000000000

17 Tipos de Extração

Extração	Descrição	Fonte
`profile`	Nome da empresa, CIK, SIC, endereço	SEC Submissions
`filings`	Lista de arquivamentos com accession + URL	SEC Submissions
`financials`	IS/BS/CF normalizados com proveniência	SEC XBRL CompanyFacts
`concepts`	Série temporal bruta de conceitos XBRL	SEC CompanyFacts
`insiders`	Arquivamentos de negociações de insiders (Form 4)	SEC EDGAR
`ownership`	Participações institucionais 13F	SEC EDGAR
`events`	Eventos materiais 8-K	SEC EDGAR
`sections`	MD&A, fatores de risco, texto de negócios	Filing HTML
`exhibits`	Lista de anexos com URLs	Filing Index
`metrics`	Mais de 50 índices financeiros (7 categorias)	XBRL + FMP Market Data
`ohlcv`	Barras de preço OHLCV diárias	FMP Historical Charts
`technicals`	SMA/EMA/RSI/MACD/Bollinger/ATR/VWAP	Calculados a partir de OHLCV
`segments`	Segmentos de receita por negócio e geografia	SEC XBRL Dimensions
`float`	Ações em float, em circulação, free float	FMP Shares Float
`corporate_actions`	Dividendos, desdobramentos, eventos 8-K mesclados	FMP + SEC EDGAR
`transcripts`	Transcrições de calls de resultados com Q&A	SEC EDGAR 8-K
`peers`	Valuation relativa vs. pares do setor	SEC XBRL + FMP

28 Conceitos Canônicos

As demonstrações financeiras são normalizadas em agrupamentos limpos de IS/BS/CF:

Demonstração de Resultados: receita, lucro_líquido, lucro_operacional, lucro_bruto, eps_básico, eps_diluído, custo_da_receita, ebitda (derivado)

Balanço Patrimonial: ativos_totais, passivos_totais, patrimônio_líquido, caixa, dívida_total, ativos_circulantes, passivos_circulantes, estoque, contas_a_receber, contas_a_pagar, dívida_de_curto_prazo, dívida_de_longo_prazo

Fluxo de Caixa: fc_operacional, capex, fc_livre (derivado), depreciação_amortização, dividendos_pagos

Outros: ações_em_circulação, despesa_de_juros

API REST

GET  /                              API discovery
GET  /health                        Health check
GET  /v1/capabilities               All 19 extracts listed
GET  /v1/sec/{identifier}           SEC data (any extract)
GET  /v1/sec/{ticker}/ohlcv         OHLCV price bars
GET  /v1/sec/{id}/export            CSV flat file download
GET  /v1/screener                   Stock screener
GET  /v1/crypto/{symbol}            Crypto quotes
GET  /v1/stream/filings             SSE real-time SEC filing alerts
GET  /v1/economics/{category}       FRED macro data

Exemplos

# Fundamentals (FY, 5 years)
curl "localhost:8000/v1/sec/AAPL?extract=financials&period=FY&limit=5"

# Financial ratios
curl "localhost:8000/v1/sec/AAPL?extract=metrics&limit=1"

# OHLCV bars
curl "localhost:8000/v1/sec/AAPL/ohlcv?from=2026-01-01&to=2026-03-14"

# Crypto
curl "localhost:8000/v1/crypto/BTCUSD"

# CSV export
curl "localhost:8000/v1/sec/AAPL/export?format=csv&limit=3"

# Real-time filing stream (SSE)
curl "localhost:8000/v1/stream/filings"

# Economics
curl "localhost:8000/v1/economics/inflation"

Formato da Resposta

Toda resposta inclui proveniência completa:

{
  "status": "success",
  "identifier": "AAPL",
  "resolved": {"ticker": "AAPL", "cik": "0000320193", "company": "Apple Inc."},
  "data": {
    "periods": [{
      "period_end": "2025-09-27",
      "metrics": { ... },
      "income_statement": { ... },
      "balance_sheet": { ... },
      "cash_flow_statement": { ... }
    }]
  },
  "provenance": [{"source": "SEC CompanyFacts (XBRL)", "url": "..."}],
  "metadata": {"service": "eugene-intelligence", "version": "0.8.0"}
}

Cada métrica financeira remonta à sua fonte XBRL:

{
  "revenue": {
    "value": 416161000000,
    "unit": "USD",
    "source_tag": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax"
  }
}

MCP (Model Context Protocol)

Claude Desktop

{
  "mcpServers": {
    "eugene": {
      "command": "python3",
      "args": ["eugene_server.py", "--mode", "mcp"]
    }
  }
}

5 Ferramentas MCP

Ferramenta	Descrição
`sec`	Todos os dados SEC EDGAR — 19 tipos de extração em uma única ferramenta
`economics`	Dados macro FRED (inflação, emprego, PIB, habitação, taxas)
`screener`	Triagem de ações por setor, capitalização de mercado, preço, volume, beta
`crypto`	Cotações de criptomoedas em tempo real (BTC, ETH, SOL, etc.)
`caps`	Lista todas as capacidades e parâmetros

HTTP Transmissível

O servidor também expõe MCP via HTTP transmissível em /mcp e SSE em /sse, para que qualquer cliente MCP possa se conectar pela rede.

Arquitetura

eugene_server.py                  FastAPI + MCP entry point (REST + stdio + SSE + streamable HTTP)
eugene/
  router.py                      Request parsing, routing, envelope (19 handlers)
  resolver.py                    ticker/CIK/accession -> identity
  concepts.py                    28 canonical concept mappings (XBRL -> stable keys)
  cache.py                       L1 in-memory + L2 persistent disk cache
  rate_limit.py                  Sync + async rate limiters
  errors.py                      Error taxonomy (NotFound, Source, Validation, RateLimit)
  auth.py                        API key authentication
  cli.py                         Click CLI (eugene command)
  handlers/
    financials.py                Normalized IS/BS/CF with derived metrics
    metrics.py                   50+ financial ratios (7 categories)
    technicals.py                SMA/EMA/RSI/MACD/Bollinger/ATR/VWAP
    ohlcv.py                     OHLCV daily price bars
    segments.py                  XBRL dimension parsing (business/geographic)
    float_data.py                Share float data
    corporate_actions.py         Dividends + splits + 8-K events merged
    export.py                    CSV flat file generation
    filings.py, profile.py       Filing list, company profile
    concepts_raw.py              Raw XBRL concept series
    sections.py                  MD&A, risk factors text extraction
    insiders.py, ownership.py    Form 4, 13F filings
    events.py, exhibits.py       8-K events, exhibit list
    options.py, orderbook.py     Coming soon stubs
  sources/
    sec_api.py                   All SEC HTTP calls (one place)
    fmp.py                       Market data (prices, OHLCV, screener, crypto, float)
    fred.py                      Economic data (FRED)

Variáveis de Ambiente

SEC_USER_AGENT=Eugene Intelligence (you@email.com)
SEC_CONTACT_NAME=Eugene Intelligence
SEC_CONTACT_EMAIL=your@email.com
FMP_API_KEY=your_fmp_key
FRED_API_KEY=your_fred_key
PORT=8000

Construído para agentes que precisam acertar nas finanças.