Skip to main content
skill CX Codex

sec-mda-analysis — Claude Code skill: what it does, how to install

sec-mda-analysis parses MD&A sections from SEC 10-K and 10-Q filings through the Octagon MCP server to track corporate strategy and risks.

MIT 258 installs ★ 132 updated 2026-06-05

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

What sec-mda-analysis does

The skill equips your AI assistant with workflows to examine the Management Discussion and Analysis section inside SEC public filings. It targets equity tickers such as AAPL or GOOGL across annual 10-K reports or quarterly 10-Q forms. The workflow surfaces details on corporate initiatives, operating cost shifts, macroeconomic headwinds, and future performance disclaimers.

Execution relies on calling the octagon-agent tool via the octagon-mcp connection. It outlines explicit patterns to track sequential or year-over-year adjustments, assess shifts in executive tone, and break down operating performance across business segments.

Without an active octagon-mcp integration configured in your agent workspace, query calls will fail.

What it helps with

  • extract corporate performance commentary from quarterly 10-Q filings
  • compare executive forward-looking statements across sequential periods
  • evaluate shifts in management tone regarding industry headwinds
  • gather capital allocation and liquidity data from annual 10-K filings

Example prompts for the agent

  • Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report
  • Extract the financial performance discussion from GOOGL's latest MD&A
  • Compare the MD&A commentary between TSLA's Q4 2025 and Q4 2024 10-Q filings

How to install sec-mda-analysis

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill sec-mda-analysis -a claude-code

2Manually: put the files in place

~/.claude/skills/sec-mda-analysis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/sec-mda-analysis/

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

Questions about sec-mda-analysis

How to install sec-mda-analysis in Claude Code?

Run npx skills add OctagonAI/skills --skill sec-mda-analysis -a claude-code in your terminal.

What does sec-mda-analysis do?

It provides structured prompts and workflows to query SEC MD&A disclosures via Octagon MCP, extracting operational drivers, strategic initiatives, and risks.

What prerequisite setup does sec-mda-analysis require?

You must have the octagon-mcp server configured inside your AI agent environment to supply the octagon-agent tool.

Source text

SKILL.md · MIT
---
name: sec-mda-analysis
description: Analyze Management Discussion and Analysis (MD&A) sections from SEC filings using Octagon MCP. Use when extracting strategic initiatives, financial performance commentary, macroeconomic challenges, and forward-looking statements from 10-K and 10-Q filings.
---

# SEC MD&A Analysis

Analyze the Management Discussion and Analysis (MD&A) section 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](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 Areas** (optional): Strategic initiatives, financial performance, risks

### 2. Execute Query via Octagon MCP

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

```
Analyze the Management Discussion and Analysis section from <TICKER>'s latest quarterly report.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report."
  }
}
```

### 3. Expected Output

The agent returns structured MD&A analysis including:

**Strategic Initiatives:**
- Launched new products: MacBook Pro, iPad Pro, Apple Vision Pro
- Increased R&D spending to drive innovation
- Continued capital return program via stock repurchases and dividends

**Macroeconomic Challenges:**
- Addressed inflation, interest rates, and currency fluctuations
- Mitigation strategies: Derivative instruments for hedging

**Financial Performance:**
- Revenue drivers: Strong iPhone and services sales
- Cost management: Improved gross margins, increased R&D expenses

**Risks & Forward-Looking Statements:**
- Key risks: Macroeconomic conditions and trade measures
- Caution on future performance: Actual results may vary

**Data Sources**: octagon-sec-agent

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding MD&A structure
- Evaluating management commentary
- Identifying key performance drivers
- Assessing forward-looking statements

## Example Queries

**Standard MD&A Analysis:**
```
Analyze the Management Discussion and Analysis section from AAPL's latest quarterly report.
```

**Annual MD&A Review:**
```
Analyze the MD&A section from MSFT's latest 10-K filing and summarize key strategic themes.
```

**Performance Commentary:**
```
Extract the financial performance discussion from GOOGL's latest MD&A.
```

**Strategic Focus:**
```
What strategic initiatives does AMZN highlight in their latest MD&A section?
```

**Comparative Analysis:**
```
Compare the MD&A commentary between TSLA's Q4 2025 and Q4 2024 10-Q filings.
```

**Segment Analysis:**
```
Analyze the segment performance discussion in META's latest MD&A.
```

## MD&A Section Components

### Results of Operations

| Component | Description |
|-----------|-------------|
| Revenue Analysis | Segment breakdown, growth drivers, geographic mix |
| Cost of Revenue | Gross margin trends, cost structure changes |
| Operating Expenses | R&D, SG&A, marketing spend trends |
| Operating Income | Margin analysis, operational leverage |
| Other Income/Expense | Interest, investments, one-time items |
| Tax Discussion | Effective rate, tax planning, credits |

### Liquidity & Capital Resources

| Component | Description |
|-----------|-------------|
| Cash Position | Cash and equivalents, investments |
| Cash Flow | Operating, investing, financing activities |
| Debt Structure | Borrowings, maturities, covenants |
| Capital Allocation | CapEx, M&A, shareholder returns |
| Working Capital | Receivables, inventory, payables |

### Critical Accounting Policies

| Component | Description |
|-----------|-------------|
| Revenue Recognition | Policies, judgments, timing |
| Estimates | Goodwill, impairments, reserves |
| Contingencies | Legal, tax, environmental |
| Fair Value | Measurement methodologies |

### Forward-Looking Statements

| Component | Description |
|-----------|-------------|
| Guidance | Revenue, earnings, margin outlook |
| Strategy | Product plans, market expansion |
| Risks | Key uncertainties, market factors |
| Safe Harbor | Legal disclaimers |

## Key Analysis Areas

### Management Tone Analysis

| Tone | Indicators |
|------|------------|
| Optimistic | "Strong performance," "exceeded expectations," "momentum" |
| Cautious | "Challenges," "headwinds," "uncertainty" |
| Defensive | "Despite," "although," "notwithstanding" |
| Confident | "Expect," "anticipate," "believe" |

### Performance Drivers

**Positive Signals:**
- Volume growth highlighted
- Market share gains
- New product success
- Margin expansion
- Operational efficiency

**Warning Signs:**
- Revenue concentration
- Margin pressure
- Increased competition
- Regulatory concerns
- One-time benefits

### Strategic Themes

| Theme | What to Look For |
|-------|------------------|
| Growth | New markets, products, acquisitions |
| Efficiency | Cost cutting, automation, restructuring |
| Innovation | R&D investment, patents, technology |
| Capital Allocation | Buybacks, dividends, CapEx |
| Risk Management | Hedging, diversification, compliance |

## Comparing MD&A Over Time

### Key Comparisons

| Period | Focus |
|--------|-------|
| Sequential (Q/Q) | Short-term trends, seasonal patterns |
| Year-over-Year (Y/Y) | Annual growth, cycle position |
| Multi-Year | Strategic evolution, long-term trends |

### Change Analysis

Track changes in:
1. **Narrative emphasis** - Topics receiving more/less attention
2. **Quantitative guidance** - Specific numbers vs. ranges
3. **Risk discussion** - New concerns vs. resolved issues
4. **Strategic priorities** - Shifting focus areas
5. **Tone** - Confidence level changes

## Analysis Tips

1. **Read between the lines**: What management doesn't discuss can be as important as what they do.

2. **Compare to prior periods**: Look for changes in emphasis, tone, and specificity.

3. **Cross-reference financials**: Verify MD&A claims against actual numbers.

4. **Note non-GAAP metrics**: Management often emphasizes adjusted figures.

5. **Track guidance accuracy**: Compare past guidance to actual results.

6. **Identify recurring themes**: Consistent messaging vs. shifting narratives.

## Use Cases

- **Earnings analysis**: Understand quarterly/annual performance drivers
- **Investment research**: Assess management quality and strategy
- **Competitive intelligence**: Compare management commentary across peers
- **Risk assessment**: Identify emerging concerns and challenges
- **Valuation support**: Gather context for financial modeling

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
sector-pe-ratios Retrieves sector P/E ratios across stock exchanges using Octagon MCP. Helps compare equity valuations against sector baselines. CX Codex +1 260installs sec-annual-comparison sec-annual-comparison compares financial metrics and risk factors between annual 10-K filings using Octagon MCP. Use it to analyze year-over-year changes in revenue, profitability, risks, and business strategy. CX Codex +1 259installs stock-historical-index stock-historical-index — a skill to fetch full daily price history for market indices via Octagon MCP. Runs when analyzing index performance, calculating returns, and benchmarking individual stocks against the market. CX Codex +1 259installs price-target-consensus price-target-consensus fetches consensus price targets for any stock: average, median, high and low analyst projections. Use it to evaluate upside potential and measure how widely analysts' views diverge. CX Codex +1 259installs sec-8k-analysis sec-8k-analysis extracts material corporate events and disclosures from SEC 8-K filings using the Octagon MCP server. CX Codex +1 258installs price-target-summary price-target-summary is a skill that retrieves analyst consensus price targets for stocks via Octagon MCP, with trends by month, quarter, year and all time. CX Codex +1 258installs stock-grades stock-grades is a skill that fetches current analyst grades and ratings from major financial institutions. Track rating changes and shifts in market sentiment for any stock. CX Codex +1 258installs sec-footnotes-analysis The sec-footnotes-analysis skill uses Octagon MCP to analyze footnotes and accounting policies in public-company SEC filings. Ask it about revenue recognition, leases, debt, or management estimates. CX Codex +1 257installs

Project sponsors

Companies that keep this analytics open