Eugene Intelligence

Financial data for AI agents. SEC XBRL fundamentals, insider trades, 13F holdings, treasury yields. Source-traced.

Financial data infrastructure for AI agents. Every number traced to source.

The first MCP-native financial data platform. One tool call gets you normalized SEC financials, 50+ computed ratios, live prices, technicals, crypto, and macro data — all with full provenance tracking. Built with async HTTP, persistent disk caching, and comprehensive error handling.

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)

# 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

Financials are normalized into clean IS/BS/CF groupings:

Income Statement:revenue, net_income, operating_income, gross_profit, eps_basic, eps_diluted, cost_of_revenue, ebitda (derived)

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

Cash Flow:operating_cf, capex, free_cf (derived), depreciation_amortization, dividends_paid

Other:shares_outstanding, interest_expense

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

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

Every response includes full provenance:

{ "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"} }

Every financial metric traces back to its XBRL source:

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

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

The server also exposes MCP via streamable HTTP at/mcpand SSE at/sse, so any MCP client can connect over the network.

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)

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

Built for agents that need to get finance right.

Institutional research and manager diligence reports on hedge funds, venture capital and private equity managers. Summary of filings, personnel changes, media screening and social signals delivered to you in minutes.

Pattern intelligence API for AI agents. Search 24M historical chart patterns, get forward returns, market regime analysis, and AI summaries for any stock ticker.

Market intelligence your AI agent can call

An AI agent providing unified access to financial market data and news articles.

Real-time business event intelligence for AI agents -- AI-scored leads, funding rounds, acquisitions, and market briefs in Claude, Cursor, or Windsurf

Financial intelligence for AI agents: an agent-readable investment loop for market regime, portfolio context, decision framing, and thesis review.

Real-time ASX market intelligence for AI agents — announcements, AI summaries, sentiment, social intelligence, stock prices, and franking credit calculator across 2,200+ Australian-listed companies.

Deliver real-time investment research with extensive private and public market data.

Provides programmatic access to Borsa Istanbul (BIST) stock data, financials, news, and analysis using KAP and Yahoo Finance.

Access and analyze Federal Reserve (FOMC) statements.