mcpField
C
cash-flow-growth

cash-flow-growth

github.com/octagonaiData & databases130269 installsUpdated 21w ago
Repository

About cash-flow-growth

This skill retrieves and analyzes year-over-year cash flow growth metrics for public companies through Octagon MCP. It supports financial and company trend analysis, with operating, free, and net cash flow data filtered by record count and reporting period.

Key features

  1. 01Retrieve year-over-year cash flow growth
  2. 02Review operating, free, and net cash flow
  3. 03Filter by fiscal year or quarter
  4. 04Analyze cash flow trends and volatility

Use cases

  1. 01Track a company's cash generation
  2. 02Assess changes in free cash flow
  3. 03Spot net cash flow volatility and inflection points
  4. 04Check earnings quality alongside income statement data

MCP support

Configure Octagon MCP in an AI agent and use the octagon-agent tool to query cash flow growth data from octagon-financials-agent.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill cash-flow-growth

After installing, type/cash-flow-growthin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

marketplace.json
README.md
references/
interpreting-results.md
mcp-setup.md

Details

From the project README

Cash Flow Growth

Retrieve and analyze year-over-year growth in cash flow metrics 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 cash-flow growth metrics for <TICKER>, limited to <N> records and filtered by period <FY|Q>.

MCP Call:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve cash-flow growth metrics for AAPL, limited to 5 records and filtered by period FY"
  }
}

Output Format

The agent returns a table with YoY growth percentages:

Fiscal YearOperating Cash Flow Growth (%)Free Cash Flow Growth (%)Net Cash Flow Growth (%)
2025-5.73-9.238.55
20246.989.26-1.14
2023-9.50-10.641.53
202217.4119.89-1.84
202128.9626.700.63

Data Source: octagon-financials-agent

Key Observations Pattern

After receiving data, generate observations:

  1. Operating cash flow trends: Core business cash generation ability
  2. Free cash flow health: Capital available for dividends, buybacks, M&A
  3. Net cash flow direction: Overall liquidity position changes
  4. Volatility assessment: Consistency of cash generation
  5. Historical context: Multi-year patterns and inflection points

Metrics Reference

MetricDefinition
Operating Cash Flow GrowthYoY change in cash from core business operations
Free Cash Flow GrowthYoY change in OCF minus Capital Expenditures
Net Cash Flow GrowthYoY change in total cash position (OCF + Investing + Financing)

Analysis Tips

Strong Cash Generation

When Operating Cash Flow Growth > Revenue Growth:

  • Efficient working capital management
  • Strong collections and payables optimization
  • Quality earnings (cash backing profits)
Free Cash Flow Divergence

When FCF Growth differs significantly from OCF Growth:

  • Capex changes driving the difference
  • Growth investments (negative) or harvesting (positive)
  • Check capex as % of revenue trend
Net Cash Flow Volatility

Net Cash Flow often volatile due to:

  • Large debt issuances or repayments
  • Share buyback programs
  • Dividend policy changes
  • M&A activity
Working Capital Impact

Significant OCF swings often driven by:

  • Inventory build/drawdown
  • Receivables collection timing
  • Payables management
  • Deferred revenue changes
Quality of Earnings Check

Compare to income statement:

  • OCF should track or exceed Net Income over time
  • Persistent OCF < Net Income signals earnings quality concerns

Follow-up Queries

Based on results, suggest deeper analysis:

  • "What drove the operating cash flow decline in [YEAR]?"
  • "Break down [COMPANY]'s working capital changes for the last 3 years"
  • "Compare [COMPANY]'s free cash flow yield to industry peers"
  • "Analyze [COMPANY]'s capital expenditure trends and guidance"

Comments

Markdown supported