mcpField
S
sec-cash-flow-review

sec-cash-flow-review

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

About sec-cash-flow-review

A skill for analyzing cash flow trends and working capital changes in public-company SEC filings. It supports reviews of operating, investing, and financing cash flows, free cash flow, liquidity, and related metrics.

Key features

  1. 01Operating, investing, and financing cash flows
  2. 02Working capital and cash-cycle analysis
  3. 03Free cash flow and cash conversion metrics
  4. 04Liquidity and cash runway assessment
  5. 05Capital expenditure and financing review

Use cases

  1. 01Assessing cash generation quality
  2. 02Evaluating debt service capacity
  3. 03Building free-cash-flow valuations
  4. 04Monitoring liquidity and working capital

MCP support

Uses the Octagon MCP server and its octagon-agent tool to analyze cash flow information in SEC filings.

Install

Copy the command and run it in a terminal.

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

After installing, type/sec-cash-flow-reviewin 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

SEC Cash Flow Review

Extract and analyze cash flow trends and working capital changes from SEC filings for public companies using the Octagon MCP server.

Prerequisites

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

Workflow

1. Identify Analysis Parameters

Determine the following before querying:

  • Ticker: Stock symbol (e.g., AAPL, MSFT, GOOGL)
  • Filing Type (optional): 10-K (annual) or 10-Q (quarterly)
  • Focus Area (optional): Operating, investing, financing, working capital
2. Execute Query via Octagon MCP

Use the octagon-agent tool with a natural language prompt:

Extract and analyze cash flow trends and working capital changes from <TICKER>'s latest 10-Q.

MCP Call Format:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Extract and analyze cash flow trends and working capital changes from NFLX's latest 10-Q."
  }
}
3. Expected Output

The agent returns structured cash flow analysis including:

Cash Flow Trends:

  • Operating Cash Flow: Increased 37.87% YoY
  • Investing Cash Flow: -$2.08B (CapEx, investments)
  • Financing Cash Flow: Mixed ($1.04B inflow, -$2.18B outflow)

Working Capital Changes:

  • Change in Working Capital: -$456M
  • Cash and Equivalents: Decreased $1.193B in 6 months

Key Observations:

  • Operating cash flow growth outpaces investing/financing
  • Working capital contraction from content investments
  • Liquidity sufficient for 12+ months

Data Sources: octagon-financials-agent, octagon-sec-agent, octagon-web-search-agent

4. Interpret Results

See references/interpreting-results.md for guidance on:

  • Understanding cash flow components
  • Evaluating cash flow quality
  • Analyzing working capital trends
  • Assessing liquidity position

Example Queries

Full Cash Flow Analysis:

Extract and analyze cash flow trends and working capital changes from NFLX's latest 10-Q.

Free Cash Flow Focus:

Calculate and analyze free cash flow trends for AAPL over the last 4 quarters.

Working Capital Deep Dive:

Analyze working capital changes and cash conversion cycle for AMZN from the latest 10-K.

Liquidity Assessment:

Evaluate TSLA's liquidity position and cash runway from the latest quarterly filing.

CapEx Analysis:

Extract capital expenditure trends and investment priorities from GOOGL's cash flow statement.

Financing Activities:

Analyze debt repayments, share buybacks, and dividend payments from MSFT's latest 10-K cash flow.

Cash Flow Statement Components

Operating Activities
ComponentDescription
Net IncomeStarting point
Depreciation/AmortizationNon-cash add-back
Stock CompensationNon-cash expense
Deferred TaxesTiming differences
Working Capital ChangesCurrent asset/liability changes
Other AdjustmentsNon-cash items
Investing Activities
ComponentDescription
Capital ExpendituresProperty, equipment purchases
AcquisitionsBusiness combinations
Investment PurchasesSecurities bought
Investment SalesSecurities sold
Asset DispositionsProperty, equipment sales
Financing Activities
ComponentDescription
Debt IssuanceBorrowings
Debt RepaymentPrincipal payments
Share IssuanceStock offerings
Share RepurchasesBuybacks
DividendsShareholder distributions

Key Cash Flow Metrics

Profitability vs. Cash
MetricCalculationWhat It Shows
Operating Cash FlowFrom statementCash from operations
Free Cash FlowOCF - CapExCash after investment
FCF MarginFCF / RevenueCash generation rate
Cash ConversionOCF / Net IncomeEarnings quality
Liquidity Metrics
MetricCalculationWhat It Shows
Cash PositionCash + equivalentsAvailable liquidity
Cash RunwayCash / Monthly BurnMonths of runway
Quick Ratio(Cash + Receivables) / Current LiabilitiesShort-term coverage
Current RatioCurrent Assets / Current LiabilitiesWorking capital
Investment Metrics
MetricCalculationWhat It Shows
CapEx IntensityCapEx / RevenueInvestment level
CapEx / D&ACapEx / DepreciationMaintenance vs. growth
Acquisition SpendFrom investingM&A activity
Investment ReturnsSales / PurchasesPortfolio activity

Working Capital Analysis

Components
ComponentIncrease MeansDecrease Means
Accounts ReceivableCash usedCash provided
InventoryCash usedCash provided
Prepaid ExpensesCash usedCash provided
Accounts PayableCash providedCash used
Accrued LiabilitiesCash providedCash used
Deferred RevenueCash providedCash used
Cash Conversion Cycle
MetricCalculation
Days Sales Outstanding(AR / Revenue) × 365
Days Inventory Outstanding(Inventory / COGS) × 365
Days Payables Outstanding(AP / COGS) × 365
Cash Conversion CycleDSO + DIO - DPO
Working Capital Trends
TrendInterpretation
Declining CCCImproved efficiency
Rising CCCCash tied up longer
Negative CCCCustomer-funded model
Stable CCCConsistent operations

Cash Flow Quality Assessment

Quality Indicators
FactorHigh QualityLow Quality
OCF vs. Net IncomeOCF > NIOCF < NI
SustainabilityRecurring sourcesOne-time items
Working CapitalStable trendsErratic changes
Non-Cash ChargesReasonable D&AExcessive add-backs
Red Flags
  1. OCF < Net Income persistently - Earnings quality concern
  2. Negative FCF - Cash consumption
  3. Rising receivables - Collection issues
  4. Inventory buildup - Demand weakness
  5. Declining payables - Supplier pressure
  6. Heavy stock compensation - Dilution concern

Trend Analysis

Period-over-Period
MetricPrior PeriodCurrentChange
Operating CF
Investing CF
Financing CF
Free Cash Flow
Working Capital
Multi-Year Trends

Track over time:

  • OCF growth trajectory
  • FCF conversion rate
  • Working capital efficiency
  • CapEx patterns
  • Capital return trends

Liquidity Assessment

Cash Position Analysis
FactorAssessment
Absolute LevelAdequate for operations
TrendGrowing or declining
vs. ObligationsCoverage of debt, commitments
vs. InvestmentAbility to fund growth
Runway Calculation
ScenarioCalculation
ConservativeCash / Average Monthly Burn
Including Revolver(Cash + Available Credit) / Burn
StressCash / Peak Monthly Burn
Covenant Considerations
FactorWhat to Check
Debt/EBITDALeverage limits
Interest CoveragePayment ability
Minimum CashRequired balances
CapEx LimitsInvestment constraints

Financing Activity Analysis

Capital Structure Changes
ActivityImplication
Debt IssuanceLeverage increase
Debt RepaymentDeleveraging
Equity IssuanceDilution, capital raise
BuybacksReturn to shareholders
DividendsCash distribution
Capital Allocation Assessment
PriorityWhat It Signals
Heavy CapExGrowth investment
Heavy BuybacksMature, returning cash
Debt FocusDeleveraging priority
M&AExternal growth
BalancedDiversified approach

Analysis Tips

  1. Compare OCF to earnings: Divergence signals quality issues.

  2. Track FCF trends: More important than net income.

  3. Analyze working capital drivers: Understand component changes.

  4. Consider seasonality: Quarterly patterns affect cash flow.

  5. Read footnotes: Capital commitments disclosed there.

  6. Check management discussion: Cash flow commentary in MD&A.

Use Cases

  • Investment analysis: Assess cash generation quality
  • Credit analysis: Evaluate debt service capability
  • Valuation: FCF-based models
  • Liquidity monitoring: Track cash position
  • Working capital efficiency: Operational assessment

Comments

Markdown supported