Prerequisites

Before installing or running Octagon 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 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-mcp-server": {
      "command": "npx",
      "args": ["-y", "octagon-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 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-mcp" (or your preferred name)
   • Type: "command"
   • Command: env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-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-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 MCP when appropriate, but you can explicitly request it by describing your investment research needs. Access the Composer via Command+L (Mac), select "Agent" next to the submit button, and enter your query.

Running with npx

env OCTAGON_API_KEY=your_octagon_api_key npx -y octagon-mcp

Manual Installation

npm install -g octagon-mcp

Documentation

For comprehensive documentation on using Octagon agents, please visit our official documentation at: https://docs.octagonagents.com

The documentation includes:

• Detailed API references
• Agent-specific query guidelines
• Examples and use cases
• Best practices for investment research

For the latest hosted MCP client setup guide, see:

• Octagon MCP Server Guide

Available Tools

The MCP server currently exposes the following tools:

octagon-agent

Orchestrates public and private market intelligence analysis.

Parameters

• prompt (string, required): natural language research request.

Example:

Compare NVIDIA and AMD on latest quarterly revenue growth, margins, and management commentary.

More examples:

• "What were Amazon's revenue and net income figures in Q4 2023?"
• "Analyze Tesla's R&D spending trends over the last 3 years."
• "What guidance did NVIDIA's CEO provide regarding AI chip demand in their latest earnings call?"
• "Compare the price-to-earnings, price-to-sales, and EV/EBITDA ratios for the top 5 semiconductor companies."
• "What was Anthropic's latest funding round size, valuation, and key investors?"
• "How many investments did Andreessen Horowitz make in AI startups in the last 12 months?"

octagon-deep-research-agent

Performs comprehensive multi-source deep research and synthesis.

Parameters

• prompt (string, required): natural language research request.

Example:

Research the impact of lower interest rates on late-stage private software valuations over the next 12 months.

More examples:

• "Extract all data fields from zillow.com/san-francisco-ca/"
• "Research the financial impact of Apple's privacy changes on digital advertising companies' revenue and margins"
• "Retrieve historical Bitcoin price data from 2023 and analyze the price volatility trends"
• "Analyze the competitive dynamics in the EV charging infrastructure market"

prediction-markets-agent

Generates research reports for Kalshi prediction market events.

Parameters

• prompt (string, required): natural language research request.
• cache (boolean, optional): controls agent variant routing.
  • omitted: prediction-markets-agent
  • false: prediction-markets-agent:refresh
  • true: prediction-markets-agent:cache

Example:

Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

prediction_markets_history

Fetches historical data for a prediction market event ticker with optional pagination and time filters.

Parameters

• event_ticker (string, required)
• limit (number, optional)
• cursor (string, optional)
• captured_from (string, optional)
• captured_to (string, optional)
• include_analysis (boolean, optional; when true, requests analysis columns)

Example:

Fetch historical data for the Kalshi event https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100

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: If you encounter rate limiting errors, reduce the frequency of your requests.

License

MIT

Individual Specialized MCP Servers

While this server provides comprehensive market intelligence combining all our specialized agents, you can also use our individual MCP servers for specific use cases:

Public Market Data Servers

• Octagon SEC Filings MCP - Dedicated server for SEC filings analysis
• Octagon Earnings Transcripts MCP - Specialized for earnings call transcript analysis
• Octagon Stock Market Data MCP - Focused on stock market data access
• Octagon Financial Statements MCP - Financial metrics and ratios analysis
• Octagon 13F Holdings MCP - Institutional ownership and Form 13F filings

Private Market Data Servers

• Octagon Private Companies MCP - Private company research and intelligence
• Octagon Investors MCP - Investor profiles and investment strategies
• Octagon Funding Data MCP - Startup funding rounds and venture capital data

Research Tools

• Octagon Deep Research MCP - Comprehensive research and web scraping capabilities

⭐ Star this repo if you find it helpful!