mcpField
S
sec-annual-comparison

sec-annual-comparison

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

About sec-annual-comparison

A skill for comparing current and prior-year 10-K filings for public companies through Octagon MCP. It helps researchers track financial, operational, strategic, and risk-factor changes across fiscal years.

Key features

  1. 01Compare financial metrics across 10-K filings
  2. 02Review changes in risk factors
  3. 03Compare segments and business descriptions
  4. 04Track strategy and disclosure changes

Use cases

  1. 01Assess a company’s year-over-year trajectory
  2. 02Support investment research and due diligence
  3. 03Monitor emerging or changing business risks
  4. 04Compare competitors’ annual disclosures

MCP support

Requires Octagon MCP configured in an AI agent and uses the `octagon-agent` tool on `octagon-mcp` to compare filing information.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill sec-annual-comparison

After installing, type/sec-annual-comparisonin 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 Annual Comparison

Compare key metrics and risk factors between current and previous year 10-K 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)
  • Years (optional): Specific fiscal years to compare
  • Focus Areas (optional): Financials, risks, segments, strategy
2. Execute Query via Octagon MCP

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

Compare key metrics and risk factors between <TICKER>'s current and previous year 10-K filings.

MCP Call Format:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Compare key metrics and risk factors between CRM's current and previous year 10-K filings."
  }
}
3. Expected Output

The agent returns structured year-over-year comparison including:

Financial Metrics:

  • Revenue: $31.353B (FY2023) vs $26.492B (FY2022) - 18.59% growth
  • Net Income: $208M (FY2023) vs $1.444B (FY2022) - significant decline
  • Total Assets: $98.849B vs $95.209B
  • Total Liabilities: $41.755B vs $37.076B

Key Changes:

  • $1.2B impairment of customer relationships and acquisition assets
  • Increased goodwill from acquisitions (Slack, Acumen, Vlocity)
  • Debt at $10.682B, covenant compliant

Risk Factors:

  • Operational, regulatory, financial, market volatility risks
  • Industry competition risks

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

4. Interpret Results

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

  • Understanding year-over-year trends
  • Identifying significant changes
  • Evaluating risk factor evolution
  • Assessing strategic shifts

Example Queries

Full Annual Comparison:

Compare key metrics and risk factors between CRM's current and previous year 10-K filings.

Multi-Year Trend:

Compare AAPL's financial performance across the last 3 fiscal years from 10-K filings.

Risk Factor Evolution:

How have TSLA's risk factors changed between FY2024 and FY2023 10-K filings?

Segment Comparison:

Compare revenue segment breakdown between GOOGL's FY2024 and FY2023 10-K filings.

Strategic Changes:

Compare the business description and strategy sections between MSFT's current and prior year 10-K.

Margin Analysis:

Compare gross margin and operating margin trends between NVDA's FY2024 and FY2023 10-K filings.

Comparison Framework

Financial Metrics
CategoryKey Metrics
RevenueTotal revenue, growth rate, segment breakdown
ProfitabilityGross profit, operating income, net income
MarginsGross margin, operating margin, net margin
Balance SheetAssets, liabilities, equity, cash, debt
Cash FlowOperating, investing, financing, free cash flow
Per ShareEPS, book value, dividends
Operational Metrics
CategoryKey Metrics
CustomersCount, retention, concentration
EmployeesHeadcount, productivity
GeographicRevenue by region, asset location
SegmentsBusiness unit performance
Risk Factors
CategoryWhat to Compare
BusinessCompetitive, operational, strategic
FinancialLiquidity, debt, currency
RegulatoryCompliance, legal
MarketEconomic, industry
TechnologyInnovation, disruption
Strategic Elements
CategoryWhat to Compare
MissionCorporate purpose
StrategyGrowth initiatives
InvestmentsR&D, CapEx, M&A
MarketsGeographic, product expansion

Year-over-Year Analysis

Financial Trend Assessment
MetricPositive TrendNegative Trend
RevenueGrowing, acceleratingDeclining, slowing
MarginsExpandingContracting
EarningsIncreasingDecreasing
Cash FlowStrengtheningWeakening
DebtDecliningIncreasing
Key Ratios to Track
RatioCalculationWhat It Shows
Revenue Growth(Current - Prior) / PriorTop-line momentum
Gross MarginGross Profit / RevenuePricing power, costs
Operating MarginOperating Income / RevenueOperational efficiency
Net MarginNet Income / RevenueBottom-line profitability
ROENet Income / EquityShareholder returns
Debt/EquityTotal Debt / EquityFinancial leverage
Change Analysis
Change TypeSignificance
>20% improvementMajor positive development
5-20% improvementSolid progress
±5%Stable/flat
5-20% declineConcerning deterioration
>20% declineMaterial negative change

Risk Factor Comparison

Types of Changes
ChangeWhat It Means
New risk addedEmerging concern
Risk removedIssue resolved or de-emphasized
Language expandedIncreased concern
Language reducedDiminished concern
Position changedPriority shift
Specificity addedCrystallizing risk
Priority Assessment
PositionPrior YearCurrent YearInterpretation
Top 5Top 5Top 5Persistent priority
LowerLowerTop 5Elevated concern
Top 5Top 5LowerReduced priority
NoneNoneAddedNew risk
PresentPresentRemovedResolved

Business Description Changes

What to Track
SectionChanges to Note
ProductsNew offerings, discontinued products
MarketsGeographic expansion, exits
CustomersTarget market shifts
CompetitionNew competitors, changed positioning
StrategyNew initiatives, changed priorities
TechnologyPlatform changes, R&D focus
Strategic Shifts
IndicatorExamples
New emphasisRepeated new terms
Removed emphasisTopics no longer discussed
Changed languageDifferent framing
QuantificationNew metrics disclosed
CommitmentSpecific targets stated

Segment Performance Comparison

Revenue Analysis
SegmentPrior YearCurrent YearGrowthMix Change
Segment A$X$YZ%+/- pp
Segment B$X$YZ%+/- pp
Segment Health Indicators
IndicatorPositiveNegative
GrowthAcceleratingDecelerating
MarginImprovingDeclining
Share of TotalIncreasing (if healthy)Declining
InvestmentIncreasingDivesting

Multi-Year Trend Analysis

3-5 Year Comparison

Track over extended periods:

  • Revenue CAGR
  • Margin trajectories
  • Balance sheet evolution
  • Risk factor patterns
  • Strategic consistency
Inflection Points
SignalWhat Changed
Growth accelerationNew product, market
Margin expansionScale, efficiency
Cash flow improvementWorking capital, CapEx
Risk emergenceNew competitive threat
Strategic pivotChanged direction

Analysis Tips

  1. Start with financials: Numbers provide objective comparison base.

  2. Read both MD&As: Management commentary reveals context.

  3. Track risk factor order: Position indicates priority.

  4. Note new disclosures: First-time mentions often significant.

  5. Compare segment detail: Business unit changes reveal strategy.

  6. Check footnote changes: Accounting policy shifts matter.

Use Cases

  • Investment research: Understand company trajectory
  • Due diligence: Track performance evolution
  • Competitive analysis: Compare across competitors
  • Risk monitoring: Identify emerging concerns
  • Earnings analysis: Context for quarterly results

Comments

Markdown supported