Octagon SEC Filings MCP

The Octagon SEC Filings MCP server provides specialized AI-powered SEC filings analysis capabilities by integrating with advanced SEC analysis agents. Covers over 8,000 public companies from SEC EDGAR with comprehensive coverage of annual and quarterly reports, offering filings, amendments, and event filings. Add unlimited SEC filings analysis functionality to any MCP client including Claude Desktop, Cursor, and other popular MCP-enabled applications.

Powered by Octagon AI - Learn more about the SEC Agent at docs.octagonagents.com

🚀 Core Differentiators

✅ Comprehensive Coverage - Over 8,000 public companies from SEC EDGAR
✅ Historical Analysis - Historical data dating back to 2018 enables robust time-series analysis
✅ Real-Time Updates - Continuous daily updates for real-time insights
✅ Universal MCP Integration - Add SEC filings analysis to any MCP client
✅ Multi-Domain Analysis - Management discussion, footnotes, risk factors, and quantitative data extraction
✅ Advanced Filing Coverage - Annual (10-K), quarterly (10-Q), offering (S-1), and event (8-K) filings

Get Your Octagon API Key

To use Octagon SEC Filings MCP, you need to:

1. Sign up for a free account at Octagon
2. After logging in, from left menu, navigate to API Keys
3. Generate a new API key
4. Use this API key in your configuration as the OCTAGON_API_KEY value

Prerequisites

Before installing or running Octagon SEC Filings MCP, you need to have npx (which comes with Node.js and npm) installed on your system.

Mac (macOS)

1. Install Homebrew (if you don't have it):

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Node.js (includes npm and npx):

   brew install node

   This will install the latest version of Node.js, npm, and npx.

3. Verify installation:

   node -v
   npm -v
   npx -v

Windows

1. Download the Node.js installer:
   • Go to https://nodejs.org/ and download the LTS version for Windows.
2. Run the installer and follow the prompts. This will install Node.js, npm, and npx.
3. Verify installation: Open Command Prompt and run:

   node -v
   npm -v
   npx -v

If you see version numbers for all three, you are ready to proceed with the installation steps below.

Installation

Running on Claude Desktop

To configure Octagon SEC Filings MCP for Claude Desktop:

1. Open Claude Desktop
2. Go to Settings > Developer > Edit Config
3. Add the following to your claude_desktop_config.json (Replace your-octagon-api-key with your Octagon API key):

{
  "mcpServers": {
    "octagon-sec-filings-mcp": {
      "command": "npx",
      "args": ["-y", "octagon-sec-filings-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

4. Restart Claude for the changes to take effect

Running on Cursor

Configuring Cursor Desktop 🖥️ Note: Requires Cursor version 0.45.6+

To configure Octagon SEC Filings MCP in Cursor:

1. Open Cursor Settings
2. Go to Features > MCP Servers
3. Click "+ Add New MCP Server"
4. Enter the following:
   • Name: "octagon-sec-filings-mcp" (or your preferred name)
   • Type: "command"
   • Command: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-sec-filings-mcp

If you are using Windows and are running into issues, try cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-sec-filings-mcp"

Replace your-octagon-api-key with your Octagon API key.

After adding, refresh the MCP server list to see the new tools. The Composer Agent will automatically use Octagon SEC Filings MCP when appropriate, but you can explicitly request it by describing your SEC analysis needs. Access the Composer via Command+L (Mac), select "Agent" next to the submit button, and enter your query.

Running on Windsurf

Add this to your ./codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "octagon-sec-filings-mcp": {
      "command": "npx",
      "args": ["-y", "octagon-sec-filings-mcp@latest"],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Running with npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-sec-filings-mcp

Manual Installation

npm install -g octagon-sec-filings-mcp

Octagon SEC Agent

Model Name: octagon-sec-agent

A specialized agent for SEC filings analysis

Capabilities

• Over 8,000 public companies from SEC EDGAR
• Comprehensive coverage of corporate filings from annual and quarterly reports (10-K, 10-Q, 20-F), offering filings (S-1), amendments, and event filings (8-K)
• Continuous daily updates for real-time insights
• Historical data dating back to 2018 enables robust time-series analysis

Use Cases

The SEC Agent is best for extracting:

• Management discussion and analysis
• Footnotes and disclosures
• Risk factors
• Quantitative data from SEC filings

Example Queries

• "What was Apple's R&D expense as a percentage of revenue in their latest fiscal year?"
• "Find the risk factors related to supply chain in Tesla's latest 10-K"
• "Extract quarterly revenue growth rates for Microsoft over the past 2 years"

How to Create Effective Prompts

When working with AI tools to extract information from SEC filings, you can use these fields as a guide to create effective prompts. Here are some strategies:

1. Be specific about the filing type: Specify which filing (10-K, 10-Q, 8-K, etc.) you want to analyze.

   • Example: "Extract the revenue and net income figures from Apple's latest 10-K filing."

2. Request multiple related fields: Group related fields to get comprehensive insights.

   • Example: "Analyze Microsoft's business segments, providing segment revenue, operating income, and year-over-year growth rates."

3. Compare across time periods: Ask for trend analysis using the same fields across multiple filings.

   • Example: "Compare Tesla's gross margin, operating margin, and net margin for the past 4 quarters."

4. Contextualize with ratios: Request calculated metrics based on raw financial data.

   • Example: "Calculate Amazon's debt-to-equity ratio, current ratio, and return on equity from its most recent 10-K."

5. Focus on narrative sections: Extract insights from textual discussions.

   • Example: "Summarize the key risk factors related to supply chain issues mentioned in Nvidia's latest annual report."

6. Cross-company comparisons: Request the same fields across competitors.

   • Example: "Compare the R&D expenses as a percentage of revenue for Google, Meta, and Amazon from their latest annual filings."

7. Layer quantitative and qualitative data: Combine financial metrics with management commentary.

   • Example: "Extract Intel's capital expenditure figures for the last fiscal year, and summarize management's discussion about their future investment plans."

8. Identify changes: Look for significant changes in reporting or circumstances.

   • Example: "Identify any changes in accounting policies or estimates in Disney's latest 10-K compared to the previous year."

SEC Filing Data Fields

Company Information

| Field | Description | |-------|-------------| | Company Name | Legal or common name of the company | | CIK | Central Index Key - unique identifier assigned by SEC | | SIC Code | Standard Industrial Classification code indicating industry category | | Exchange | Stock exchange where shares are traded (e.g., NYSE, NASDAQ) | | Ticker Symbol | Stock trading symbol | | State of Incorporation | State or country where company is legally incorporated | | Fiscal Year End | Date marking the end of company's fiscal year | | Company Website | Official company website URL | | Company Address | Headquarters or principal office location | | Incorporation Date | Date when the company was legally formed | | Reporting Status | Current filing status (e.g., Large Accelerated Filer, Non-Accelerated Filer) |

Financial Statements

| Field | Description | |-------|-------------| | Revenue | Total income from company's primary business activities | | Net Income | Profit after all expenses, taxes, and costs | | EBITDA | Earnings Before Interest, Taxes, Depreciation, and Amortization | | Gross Profit | Revenue minus cost of goods sold | | Operating Income | Profit from core business operations | | Total Assets | Sum of all assets owned by the company | | Total Liabilities | Sum of all debts and obligations | | Shareholders' Equity | Company's net value to shareholders | | Cash & Equivalents | Liquid assets readily convertible to cash | | Accounts Receivable | Money owed to company by customers | | Inventory | Goods available for sale or materials for production | | Total Debt | Sum of short-term and long-term debt obligations | | Long-term Debt | Debt obligations due in more than one year | | R&D Expenses | Money spent on research and development activities | | Capital Expenditures | Funds used to acquire or upgrade physical assets | | Operating Cash Flow | Cash generated from normal business operations | | Free Cash Flow | Operating cash flow minus capital expenditures |

Segment Information

| Field | Description | |-------|-------------| | Business Segment Revenue | Revenue breakdown by business division or product line | | Geographic Segment Revenue | Revenue breakdown by geographic region | | Segment Operating Income | Profit by business segment | | Segment Assets | Assets allocated to specific business segments | | Segment Liabilities | Liabilities associated with specific segments | | Customer Concentration | Percentage of revenue from top customers | | Product Revenue Breakdown | Revenue by product or service category |

Management & Governance

| Field | Description | |-------|-------------| | CEO Name | Chief Executive Officer's full name | | CEO Compensation | Total compensation package for CEO | | Executive Officers | List of key executive management personnel | | Board Members | List of directors serving on the board | | Director Independence | Percentage of independent directors on board | | Insider Ownership | Percentage of shares owned by insiders | | Institutional Ownership | Percentage of shares owned by institutions | | Auditor | External accounting firm performing audit |

Risk Factors

| Field | Description | |-------|-------------| | Key Risk Factors | Material risks facing the business | | Risk Categories | Classification of risks (e.g., operational, financial, regulatory) | | Cybersecurity Risks | Specific risks related to data security and breaches | | Legal Proceedings | Material legal cases and litigation risks | | Regulatory Risks | Risks related to government regulations and compliance | | Competitor Risks | Risks posed by market competition | | Supply Chain Risks | Risks related to suppliers and production | | Environmental Risks | Climate and environmental impact risks |

Forward-Looking Information

| Field | Description | |-------|-------------| | Revenue Guidance | Management's revenue projections for future periods | | Earnings Guidance | Management's earnings projections for future periods | | Strategic Initiatives | Planned business strategies and initiatives | | Expansion Plans | Plans for geographic or product expansion | | R&D Pipeline | Products or services under development | | Market Opportunity | Addressable market size and growth potential | | Competitive Positioning | Company's position relative to competitors |

Corporate Actions

| Field | Description | |-------|-------------| | Share Repurchases | Stock buyback programs and activities | | Dividend Payments | Historical and planned dividend distributions | | Mergers & Acquisitions | Completed and pending M&A transactions | | Divestitures | Sales of business units or significant assets | | Restructuring Plans | Organizational changes and cost-cutting initiatives | | Capital Raising | Equity or debt issuance activities |

ESG Information

| Field | Description | |-------|-------------| | Environmental Metrics | Carbon emissions and environmental impact data | | Social Responsibility | Diversity statistics and social impact initiatives | | Governance Practices | Board structure and corporate governance policies | | Sustainability Goals | Target metrics for environmental sustainability | | ESG Risks | Specific risks related to environmental, social, and governance factors | | Supply Chain Ethics | Labor practices and ethical standards in supply chain |

Footnotes & Disclosures

| Field | Description | |-------|-------------| | Accounting Policies | Summary of significant accounting methods used | | Off-Balance Sheet Arrangements | Obligations not reflected on the balance sheet | | Related Party Transactions | Business dealings with affiliated entities | | Subsequent Events | Significant events occurring after the reporting period | | Non-GAAP Reconciliations | Reconciliation between GAAP and non-GAAP metrics | | Tax Disclosures | Details on income tax positions and rates | | Pension & Benefit Plans | Information on employee retirement and benefit plans |

Features

✅ Comprehensive SEC Filings Analysis

• Annual reports (10-K) analysis
• Quarterly reports (10-Q) analysis
• Current reports (8-K) analysis
• Offering documents (S-1) analysis
• Amendments and event filings
• Management discussion and analysis extraction

✅ Universal Company Coverage

• Over 8,000 public companies
• All major SEC filing types
• Real-time filing updates
• Historical data back to 2018
• Cross-filing comparisons
• Time-series analysis

✅ Advanced Analysis Tools

• Risk factor extraction
• Financial metrics analysis
• Executive compensation analysis
• Business segment breakdowns
• Regulatory compliance tracking

Available Tool

octagon-sec-agent

Comprehensive SEC filings analysis across over 8,000 public companies.

The tool uses a single prompt parameter that accepts a natural language query. Include all relevant details in your prompt for optimal results.

Documentation

For comprehensive documentation on using SEC Filings capabilities, please visit our official documentation at: https://docs.octagonagents.com

Specifically for the SEC Agent: SEC Agent Guide

The documentation includes:

• Detailed API references
• SEC filing analysis methodology guidelines
• Examples and use cases
• Best practices for SEC filings analysis
• Advanced features and capabilities

Troubleshooting

1. API Key Issues: Ensure your Octagon API key is correctly set in the environment or config file.
2. Connection Issues: Make sure the connectivity to the Octagon API is working properly.
3. Rate Limiting: No rate limits apply to SEC Filings MCP - execute unlimited queries.

License

MIT

⭐ Star this repo if you find it helpful for your SEC filings analysis needs!