income-statement

Retrieve real-time income statement data including Revenue, Net Income, and EPS Diluted for public companies. Use when analyzing absolute financial figures, historical earnings, or comparing company scale across fiscal periods.

27 stars

Best use case

income-statement is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Retrieve real-time income statement data including Revenue, Net Income, and EPS Diluted for public companies. Use when analyzing absolute financial figures, historical earnings, or comparing company scale across fiscal periods.

Teams using income-statement should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/income-statement/SKILL.md --create-dirs "https://raw.githubusercontent.com/OctagonAI/skills/main/skills/income-statement/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/income-statement/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How income-statement Compares

Feature / Agentincome-statementStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Retrieve real-time income statement data including Revenue, Net Income, and EPS Diluted for public companies. Use when analyzing absolute financial figures, historical earnings, or comparing company scale across fiscal periods.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Income Statement

Retrieve real-time income statement data for public companies using Octagon MCP.

## Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.

## Query Format

```
Retrieve real-time income statement data for <TICKER>, limited to <N> records and filtered by period <FY|Q>.
```

**MCP Call:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve real-time income statement data for AAPL, limited to 5 records and filtered by period FY"
  }
}
```

## Output Format

The agent returns a table with absolute financial figures:

| Fiscal Year | Revenue (USD) | Net Income (USD) | EPS (Diluted) |
|-------------|---------------|------------------|---------------|
| 2025 | $416,161,000,000 | $112,010,000,000 | 7.46 |
| 2024 | $391,035,000,000 | $93,736,000,000 | 6.08 |
| 2023 | $383,285,000,000 | $96,995,000,000 | 6.13 |
| 2022 | $394,328,000,000 | $99,803,000,000 | 6.11 |
| 2021 | $365,817,000,000 | $94,680,000,000 | 5.61 |

**Data Source:** octagon-financials-agent

## Key Observations Pattern

After receiving data, generate observations:

1. **Revenue trajectory**: Calculate dollar and percentage changes year-over-year
2. **Net income trends**: Track profitability in absolute terms
3. **EPS progression**: Note earnings per share expansion or contraction
4. **Margin calculation**: Compute Net Income / Revenue for net margin
5. **Scale context**: Compare figures to industry peers

## Metrics Reference

| Metric | Definition |
|--------|------------|
| Revenue | Total sales/top-line income for the period |
| Net Income | Bottom-line profit after all expenses and taxes |
| EPS (Diluted) | Earnings per share assuming all dilutive securities converted |

## Analysis Tips

### Revenue Scale
- Use to compare company size across industry
- Track absolute dollar growth, not just percentages
- Larger base requires more absolute growth to maintain % growth

### Net Income Quality
- Compare Net Income to Operating Income for non-operating items
- Check for one-time gains/losses distorting figures
- Look for consistent growth trajectory

### EPS Analysis
- EPS can grow faster than Net Income due to buybacks
- Compare to analyst estimates and guidance
- Check shares outstanding for context

### Margin Calculation
Calculate from the data:
```
Net Margin = Net Income / Revenue × 100
```

Example: $112B / $416B = 26.9% net margin

### Period Comparisons
- FY for annual strategic view
- Q for seasonal patterns and recent trends
- Compare same periods (Q1 vs Q1) for seasonality

## Follow-up Queries

Based on results, suggest deeper analysis:

- "What factors contributed to the revenue growth in [YEAR]?"
- "How does [COMPANY]'s [YEAR] net margin compare to industry peers?"
- "What are the key drivers of the EPS expansion over the [N]-year period?"
- "Retrieve quarterly income statement data for [TICKER] to see seasonal patterns"

Related Skills

income-statement-growth

27
from OctagonAI/skills

Retrieve year-over-year growth in income statement items including Revenue, Gross Profit, Operating Income, Net Income, and EPS Diluted. Use when analyzing company financial growth trends, comparing fiscal year performance, or identifying profitability inflection points.

cash-flow-statement

27
from OctagonAI/skills

Retrieve real-time or historical cash flow statement data including Net Income, Operating Cash Flow, Investing Cash Flow, Financing Cash Flow, Free Cash Flow, and Cash Position for public companies. Use when analyzing cash generation, capital allocation, or liquidity trends.

stock-quote

27
from OctagonAI/skills

Retrieve real-time stock quotes using Octagon MCP. Use when you need current price, day range, 52-week range, volume, market cap, and moving averages for any publicly traded stock.

stock-price-change

27
from OctagonAI/skills

Retrieve stock price change statistics across multiple time periods using Octagon MCP. Use when analyzing short-term and long-term returns, comparing performance across timeframes, and evaluating momentum and historical growth.

stock-performance

27
from OctagonAI/skills

Retrieve stock price data and performance metrics using Octagon MCP. Use when analyzing daily closing prices, trading volume, price trends, historical performance, and comparing stock movements over specific time periods.

stock-historical-index

27
from OctagonAI/skills

Retrieve full historical end-of-day price data for market indices using Octagon MCP. Use when analyzing index performance over time, tracking market trends, calculating returns, and understanding market context for individual stock analysis.

stock-grades

27
from OctagonAI/skills

Retrieve the latest stock grades and ratings from top analysts and financial institutions using Octagon MCP. Use when tracking analyst upgrades, downgrades, rating changes, and institutional sentiment over time.

sector-performance-snapshot

27
from OctagonAI/skills

Retrieve a snapshot of market sector performance using Octagon MCP. Use when analyzing sector-wide metrics including revenue, EBITDA, net income, market cap, and enterprise value for companies within a specific sector and exchange.

sector-pe-ratios

27
from OctagonAI/skills

Retrieve sector P/E ratios using Octagon MCP. Use when comparing company valuations to sector benchmarks, analyzing sector valuations across exchanges, and understanding market-wide valuation trends.

sec-risk-factors

27
from OctagonAI/skills

Extract and summarize risk factors from SEC filings using Octagon MCP. Use when analyzing Item 1A risk disclosures, categorizing business risks, identifying new or material risks, and comparing risk profiles across companies or time periods.

sec-proxy-analysis

27
from OctagonAI/skills

Analyze proxy statements (DEF 14A) to extract executive compensation, governance information, and shareholder voting matters using Octagon MCP. Use when researching CEO pay, board composition, say-on-pay votes, and corporate governance practices.

sec-mda-analysis

27
from OctagonAI/skills

Analyze Management Discussion and Analysis (MD&A) sections from SEC filings using Octagon MCP. Use when extracting strategic initiatives, financial performance commentary, macroeconomic challenges, and forward-looking statements from 10-K and 10-Q filings.