mcp-registry/octagon-mcp-server

    ==================
      
       /// MCP ///
      /// OCT ///
        
    ==================
        
    [server:online]
    [protocol:ready]

octagon-mcp-server

by OctagonAI

A Model Context Protocol (MCP) server that exposes Octagon’s AI-powered market-intelligence agents (SEC filings, earnings transcripts, stock & crypto data, private-market transactions, deep research) to Claude Desktop, Cursor, Windsurf and any other MCP-compliant client.

57
8
Specialized
GitHubWebsiteDocumentationNPM

01

octagon-agent

Orchestrates all agents for comprehensive market intelligence analysis across public and private markets, combining insights from SEC filings, earnings calls, financial metrics, stock data, institutional holdings, private company research, funding analysis, M&A transactions, investor intelligence, and debt analysis.

02

octagon-scraper-agent

Specialized agent that extracts structured financial data from investor relations websites, tables, and other online financial sources—ideal for gathering data from sites without accessible APIs.

03

octagon-deep-research-agent

Aggregates information from multiple sources for deep, up-to-date investment research, synthesizing data to provide comprehensive analysis of public and private markets.

Installation

1. Clone the repository
git clone https://github.com/OctagonAI/octagon-mcp-server.git cd octagon-mcp-server
2. Install Node.js dependencies (requires Node.js ≥18)
npm install # or yarn install
3. Environment configuration
• Copy the sample file and edit it:
• Fill in the required credentials/tokens. Typical variables include:
cp .env.example .env PORT=3000 SEC_API_KEY=YOUR_SEC_KEY IEX_TOKEN=YOUR_IEX_TOKEN OPENAI_API_KEY=YOUR_OPENAI_KEY ALPHA_VANTAGE_KEY=YOUR_ALPHA_KEY ...
4. Run database migrations (if you enabled persistence)
npm run migrate
5. Start the MCP server
npm start # default production mode npm run dev # hot-reload during development
6. Connect an MCP client (e.g., Claude Desktop)
• In the client settings add a custom MCP endpoint:
• Provide the same API key you placed in .env (header: x-api-key) if auth is enabled.
http://localhost:3000/mcp
7. (Optional) Docker deployment
docker build -t octagon-mcp-server . docker run --env-file .env -p 3000:3000 octagon-mcp-server

Documentation

License: MIT License
Updated 7/30/2025