octagon-sec-filings-mcp

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

Financial Statements

Segment Information

Management & Governance

Risk Factors

Forward-Looking Information

Corporate Actions

ESG Information

Footnotes & Disclosures

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!