Skip to main content
skill CX Codex

income-statement — Claude Code skill: company income statement data

A skill that retrieves income statement data for public companies via Octagon MCP: revenue, net income, and EPS for selected periods.

MIT 275 installs ★ 132 updated 2026-06-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill income-statement -a claude-code
Open on GitHub

What income-statement does

The skill fetches real-time income statement data: Revenue, Net Income, and EPS Diluted for fiscal years or quarters. Request a ticker, record limit, and period filter (FY for annual, Q for quarterly). The agent returns a table with absolute figures, data source attribution, and an analysis pattern covering revenue trajectory, profitability trends, and margin calculations.

Requires Octagon MCP configured in your agent. Without it, queries fail. The skill operates through octagon-agent with a JSON call, passing a prompt like "Retrieve real-time income statement data for AAPL, limited to 5 records and filtered by period FY" in the arguments.prompt field.

Output includes a year-by-year table with revenue, net income, and EPS, plus follow-up suggestions: compare margins with peers, identify EPS growth drivers, check quarterly data for seasonal patterns.

What it helps with

  • retrieve revenue, net income, and EPS for a public company across multiple years
  • compare company scale using absolute financial figures
  • calculate net margin and track its trajectory
  • verify profitability trends and spot anomalies
  • query quarterly data to analyze seasonal patterns

Example prompts for the agent

  • Show income statement for TSLA over the last five years
  • Get net income data for MSFT, annual periods only, three records
  • Compare revenue and net margin for AAPL and GOOGL in 2024

How to install income-statement

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill income-statement -a claude-code

2Manually: put the files in place

~/.claude/skills/income-statement/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/income-statement/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about income-statement

How to install income-statement in Claude Code?

Run npx skills add OctagonAI/skills --skill income-statement -a claude-code, the skill will appear in ~/.claude/skills/income-statement/SKILL.md.

What does income-statement do?

Retrieves income statement data for public companies: revenue, net income, and EPS for selected fiscal years or quarters via Octagon MCP.

What does income-statement require to work?

Octagon MCP must be configured in your agent. Without it, queries will not execute — the skill calls octagon-agent to fetch data.

Source text

SKILL.md · MIT
---
name: income-statement
description: 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.
---

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

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
earnings-analyst-master The earnings-analyst-master skill breaks down earnings calls, tracks guidance and management signals, then turns the findings into a structured research report. CX Codex +1 278installs analyst-estimates analyst-estimates is a Claude Code skill that fetches public-company revenue and EPS forecasts with estimate ranges and analyst counts. It supports review of forward expectations or valuation inputs. CX Codex +1 277installs esg-benchmark-comparison The esg-benchmark-comparison skill retrieves sector-level ESG benchmarks through Octagon MCP. Use it to compare industries, company performance, or regional metrics for a chosen fiscal year. CX Codex +1 276installs cash-flow-growth cash-flow-growth pulls year-over-year growth for operating, free, and net cash flow of public companies via Octagon MCP. Useful when reviewing corporate liquidity and capital efficiency. CX Codex +1 275installs financial-growth financial-growth fetches year-over-year growth metrics across income and cash flow statements for public companies. CX Codex +1 273installs financial-health-scores financial-health-scores is a Claude Code skill that retrieves Altman Z-Score and Piotroski Score for public companies via Octagon MCP. Use the metrics to assess bankruptcy risk and balance sheet quality. CX Codex +1 272installs earnings-financial-guidance earnings-financial-guidance extracts revenue targets, segment details, and risk factors from corporate earnings calls. It tracks forward-looking management guidance against reported quarter results. CX Codex +1 271installs earnings-qa-analysis earnings-qa-analysis is a Claude Code skill that analyzes earnings call Q&A, extracting strategic direction, analyst concerns, and candid management answers. CX Codex +1 269installs

Project sponsors

Companies that keep this analytics open