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 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:
{
"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:
- Revenue trajectory: Calculate dollar and percentage changes year-over-year
- Net income trends: Track profitability in absolute terms
- EPS progression: Note earnings per share expansion or contraction
- Margin calculation: Compute Net Income / Revenue for net margin
- 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"
1---2name: income-statement3description: 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.4---5
6# Income Statement
7
8Retrieve real-time income statement data for public companies using Octagon MCP.
9
10## Prerequisites
11
12Ensure 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.
13
14## Query Format
15
16```
17Retrieve real-time income statement data for <TICKER>, limited to <N> records and filtered by period <FY|Q>.
18```
19
20**MCP Call:**
21
22```json
23{
24 "server": "octagon-mcp",
25 "toolName": "octagon-agent",
26 "arguments": {
27 "prompt": "Retrieve real-time income statement data for AAPL, limited to 5 records and filtered by period FY"
28 }
29}
30```
31
32## Output Format
33
34The agent returns a table with absolute financial figures:
35
36| Fiscal Year | Revenue (USD) | Net Income (USD) | EPS (Diluted) |
37|-------------|---------------|------------------|---------------|
38| 2025 | $416,161,000,000 | $112,010,000,000 | 7.46 |
39| 2024 | $391,035,000,000 | $93,736,000,000 | 6.08 |
40| 2023 | $383,285,000,000 | $96,995,000,000 | 6.13 |
41| 2022 | $394,328,000,000 | $99,803,000,000 | 6.11 |
42| 2021 | $365,817,000,000 | $94,680,000,000 | 5.61 |
43
44**Data Source:** octagon-financials-agent
45
46## Key Observations Pattern
47
48After receiving data, generate observations:
49
501. **Revenue trajectory**: Calculate dollar and percentage changes year-over-year
512. **Net income trends**: Track profitability in absolute terms
523. **EPS progression**: Note earnings per share expansion or contraction
534. **Margin calculation**: Compute Net Income / Revenue for net margin
545. **Scale context**: Compare figures to industry peers
55
56## Metrics Reference
57
58| Metric | Definition |
59|--------|------------|
60| Revenue | Total sales/top-line income for the period |
61| Net Income | Bottom-line profit after all expenses and taxes |
62| EPS (Diluted) | Earnings per share assuming all dilutive securities converted |
63
64## Analysis Tips
65
66### Revenue Scale
67- Use to compare company size across industry
68- Track absolute dollar growth, not just percentages
69- Larger base requires more absolute growth to maintain % growth
70
71### Net Income Quality
72- Compare Net Income to Operating Income for non-operating items
73- Check for one-time gains/losses distorting figures
74- Look for consistent growth trajectory
75
76### EPS Analysis
77- EPS can grow faster than Net Income due to buybacks
78- Compare to analyst estimates and guidance
79- Check shares outstanding for context
80
81### Margin Calculation
82Calculate from the data:
83```
84Net Margin = Net Income / Revenue × 100
85```
86
87Example: $112B / $416B = 26.9% net margin
88
89### Period Comparisons
90- FY for annual strategic view
91- Q for seasonal patterns and recent trends
92- Compare same periods (Q1 vs Q1) for seasonality
93
94## Follow-up Queries
95
96Based on results, suggest deeper analysis:
97
98- "What factors contributed to the revenue growth in [YEAR]?"
99- "How does [COMPANY]'s [YEAR] net margin compare to industry peers?"
100- "What are the key drivers of the EPS expansion over the [N]-year period?"
101- "Retrieve quarterly income statement data for [TICKER] to see seasonal patterns"
octagonai