eugene-intelligence 0.1.1

Data Infrastructure for AI Agents — SEC, FRED, FMP

Eugene Intelligence

Data Infrastructure for AI Agents

Install: pip install eugene-intelligence
Import: import eugene

---

Quick Start

from eugene.tools.institutional import company

# Stock quote
result = company("AAPL", "prices")
print(result["data"]["price"]["formatted"])  # $270.58

# SEC financials with full provenance
result = company("AAPL", "financials")
print(result["data"]["revenue"]["formatted"])  # $416.16B
print(result["data"]["revenue"]["sec_concept"])  # RevenueFromContractWithCustomerExcludingAssessedTax
print(result["data"]["revenue"]["accession_number"])  # 0000320193-25-000079

---

MCP Server (Claude Desktop)

After pip install eugene-intelligence:

{
  "mcpServers": {
    "eugene": {
      "command": "python",
      "args": ["-m", "eugene.mcp_server"]
    }
  }
}

4 Tools:

Tool	Description	Types
company	Company data	prices, profile, financials, health, earnings, insider
economy_data	Economic indicators	inflation, employment, gdp, housing, treasury, forex
regulatory_data	Government & regulatory	sec_press, fed_speeches, fomc, treasury_debt
research_report	AI-powered analysis	equity, credit

---

Data Sources

Source	Data
SEC XBRL	Financial statements (10-K, 10-Q) with accession numbers
SEC EDGAR	Insider trades (Form 4), 13F holdings
FRED	400K+ economic series
FMP	Real-time stock prices
Fed RSS	Speeches, FOMC statements
Treasury	National debt, yields

---

Environment Variables

# Required for SEC API
export SEC_USER_AGENT="YourApp/1.0 (contact: [e-mail])"

# Optional
export FRED_API_KEY=your_key
export FMP_API_KEY=your_key

---

Compliance & Fair Access

• Requires SEC_USER_AGENT with contact info (per SEC policy)
• Default rate limit: 6 requests/second
• Uses CIK and companyfacts caching to reduce load

---

Demo

Try it: huggingface.co/spaces/Rex165/eugene-intelligence

---

Why Eugene?

Every number traced to source. No hallucination.

{
  "revenue": {
    "value": 416161000000,
    "formatted": "$416.16B",
    "period_end": "2025-09-27",
    "filed_date": "2025-10-31",
    "sec_concept": "RevenueFromContractWithCustomerExcludingAssessedTax",
    "accession_number": "0000320193-25-000079"
  }
}

---

Built for agents that need to get finance right.