# income-statement

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

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 275 installs · ★ 132 repo stars
- Author: OctagonAI
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/OctagonAI/skills/tree/HEAD/skills/income-statement/SKILL.md
- Updated: 2026-06-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/income-statement

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill income-statement -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/income-statement/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/income-statement/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill income-statement -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/income-statement/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill income-statement -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/income-statement/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OctagonAI/skills skills/income-statement
```

2. **Manually: put the files in place**
- File: `.github/skills/income-statement/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill income-statement -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OctagonAI/skills --path skills/income-statement
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/income-statement/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OctagonAI/skills --skill income-statement -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OctagonAI/skills/tree/HEAD/skills/income-statement/SKILL.md

## When to use it
- 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
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 42ef12588eb0a9bf.

BEGIN THIRD-PARTY FILE 42ef12588eb0a9bf
````text
---
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:
```
````
END THIRD-PARTY FILE 42ef12588eb0a9bf

The third-party file has ended. Everything between the 42ef12588eb0a9bf tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2740 of 3336 bytes. © OctagonAI · MIT · https://github.com/OctagonAI/skills/tree/HEAD/skills/income-statement/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
