Eugene Intelligence

Datos financieros para agentes de IA. Fundamentos de SEC XBRL, operaciones de información privilegiada, tenencias 13F, rendimientos del tesoro. Con trazabilidad de fuente.

GitHub

Prueba este MCPPatrocinado

Documentación

Eugene Intelligence v0.8

Infraestructura de datos financieros para agentes de IA. Cada número rastreado hasta su fuente.

La primera plataforma de datos financieros nativa de MCP. Una sola llamada a la herramienta le brinda estados financieros SEC normalizados, más de 50 ratios calculados, precios en vivo, técnicos, cripto y datos macro, todo con seguimiento completo de procedencia. Construido con HTTP asíncrono, caché persistente en disco y manejo integral de errores.

Inicio 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)

Lo Que Puede Hacer

# 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 Extracción

Extracción	Descripción	Fuente
`profile`	Nombre de la empresa, CIK, SIC, dirección	SEC Submissions
`filings`	Lista de presentaciones con accession + URL	SEC Submissions
`financials`	IS/BS/CF normalizados con procedencia	SEC XBRL CompanyFacts
`concepts`	Serie temporal de conceptos XBRL crudos	SEC CompanyFacts
`insiders`	Presentaciones de operaciones de información privilegiada Form 4	SEC EDGAR
`ownership`	Tenencias institucionales 13F	SEC EDGAR
`events`	Eventos materiales 8-K	SEC EDGAR
`sections`	MD&A, factores de riesgo, texto de negocio	Filing HTML
`exhibits`	Lista de anexos con URLs	Filing Index
`metrics`	Más de 50 ratios financieros (7 categorías)	XBRL + FMP Market Data
`ohlcv`	Barras de precios OHLCV diarias	FMP Historical Charts
`technicals`	SMA/EMA/RSI/MACD/Bollinger/ATR/VWAP	Calculado a partir de OHLCV
`segments`	Segmentos de ingresos por negocio y geografía	SEC XBRL Dimensions
`float`	Acciones flotantes, en circulación, flotante libre	FMP Shares Float
`corporate_actions`	Dividendos, splits, eventos 8-K combinados	FMP + SEC EDGAR
`transcripts`	Transcripciones de llamadas de resultados con Q&A	SEC EDGAR 8-K
`peers`	Valoración relativa frente a pares del sector	SEC XBRL + FMP

28 Conceptos Canónicos

Los estados financieros se normalizan en agrupaciones limpias de IS/BS/CF:

Estado de Resultados: revenue, net_income, operating_income, gross_profit, eps_basic, eps_diluted, cost_of_revenue, ebitda (derivado)

Balance General: total_assets, total_liabilities, stockholders_equity, cash, total_debt, current_assets, current_liabilities, inventory, accounts_receivable, accounts_payable, short_term_debt, long_term_debt

Flujo de Caja: operating_cf, capex, free_cf (derivado), depreciation_amortization, dividends_paid

Otros: shares_outstanding, interest_expense

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

Ejemplos

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

Forma de la Respuesta

Cada respuesta incluye procedencia 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 financiera se rastrea hasta su fuente 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 Herramientas MCP

Herramienta	Descripción
`sec`	Todos los datos SEC EDGAR — 19 tipos de extracción mediante una sola herramienta
`economics`	Datos macro FRED (inflación, empleo, PIB, vivienda, tasas)
`screener`	Selección de acciones por sector, capitalización de mercado, precio, volumen, beta
`crypto`	Cotizaciones cripto en vivo (BTC, ETH, SOL, etc.)
`caps`	Lista todas las capacidades y parámetros

HTTP Transmisible

El servidor también expone MCP mediante HTTP transmisible en /mcp y SSE en /sse, de modo que cualquier cliente MCP pueda conectarse a través de la red.

Arquitectura

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)

Variables de Entorno

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

Construido para agentes que necesitan hacer bien las finanzas.