← Back to directory

Octagon MCP Server

Community

An MCP server for public & prediction markets research, providing source-backed answers.

GitHub source repository ↗

★ 147 Stars Category · Other Popular Source revision a3234633fbcc

39FMRS · D

Reliability

6/20

Security and permissions

8/20

Maintenance

8/20

Documentation

9/20

Setup experience

8/20

This server provides rich market research and analysis tools via an API key, suitable for investors and analysts, with some caveats regarding API limits and key management.

Read the FMRS scoring method →

The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API, enabling users to analyze and extract insights from public filings, earnings calls, financial metrics, stocks & crypto data, stock news, and prediction markets news & research within Claude Desktop and other popular MCP clients. It offers a variety of tools for market intelligence analysis, deep research, prediction market research, and documentation access.

Tools

octagon-agent

Orchestrates broad market intelligence analysis.

octagon-deep-research-agent

Performs comprehensive multi-source deep research and synthesis.

octagon-prediction-markets-agent

Generates research reports for Kalshi prediction market events.

prediction_markets_history

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

octagon-docs-search

Searches the Octagon API, agent, MCP, and plugin docs with source URLs and optional snippets.

octagon-docs-read

Reads one docs page or section as Markdown.

octagon-docs-list

Lists live docs sections and pages from the Octagon docs corpus.

octagon-docs-refresh

Refreshes the in-memory docs catalog from live LLM-friendly docs endpoints.

Setup

Sign up for a free account at Octagon. 2. After logging in, navigate to API Keys from the left menu and generate a new API key. 3. Use this API key as the OCTAGON_API_KEY value in your configuration. 4. For Claude Desktop, edit claude_desktop_config.json and add the configuration above, replacing YOUR_API_KEY_HERE. 5. Restart Claude. For Cursor, add the command env OCTAGON_API_KEY=your-octagon-api-key npx -y octagon-mcp in MCP server settings.

claude_desktop_config.json

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

Generate and validate client config

Fit and risk

Best for

Investors and financial analysts who need fast, cited intelligence.
Researchers needing comprehensive market intelligence across SEC filings, calls, and market data.
Users interested in researching prediction market events (e.g., Kalshi markets).

Not for

Users who do not want to sign up for an Octagon API key.
Users needing live trading or order execution capabilities.
Users wishing to host the server on non-stdio transports (e.g., SSE or HTTP).

Required permissions

Requires a valid OCTAGON_API_KEY to access the Octagon API.
Documentation tools work even without the API key; they fetch docs from public endpoints.
Requires network access for npx to fetch the package and for API calls.

Risks and side effects

API key exposure may lead to unauthorized access and potential charges.
Dependency on third-party API (Octagon) availability and accuracy.
Generated research may not reflect real-time market data and could be outdated.

Troubleshooting

API Key Issues: Ensure your Octagon API key is correctly set in the environment or config file.
Connection Issues: Make sure the connectivity to the Octagon API is working properly.
Rate Limiting: If you encounter rate limiting errors, reduce the frequency of your requests.

Use cases

Analyze SEC filings, earnings call transcripts, and financial metrics.

Get stock and crypto market data, including news and ownership.

Generate research reports for prediction market events.

Perform multi-source deep research for investment analysis.

Supported clients

Claude DesktopFull support

CursorFull support

Related MCP servers

Compare with other MCP servers