M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
O

Octagon MCP Server

Community
An MCP server for public & prediction markets research, providing source-backed answers.
How to install ↓ Compare GitHub source repository ↗
Category
Other #199 of 230
Stars
★ 147 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
API key / credential required
License
MIT
Last commit
Tools
8
39FMRS · D

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.

Strongest · Documentation 9/20 Weakest · Reliability 6/20

Reliability
6/20
Security and permissions
8/20
Maintenance
8/20
Documentation
9/20
Setup experience
8/20
Why each score
Reliability 6/20
Evidence: The README describes tools in detail (agents, docs tools, prediction_markets_history) and explains stateful tool policy and structured output. However, actual behavior cannot be verified from static review; no CI or tests are provided. Deductions: No verifiable execution evidence; static review limits confidence.
Security and permissions 8/20
Evidence: API key is passed via environment variable; docs tools explicitly do not use or transmit the API key; README shows no embedded secrets. Deductions: External API calls are made without detailed data-flow disclosure; no confirmation for dangerous operations; moderate risk due to static review.
Maintenance 8/20
Evidence: Repository is active (146 stars, 4 open issues, not archived), has MIT license, and README shows ongoing updates. Deductions: No detailed commit history or release cadence; dependency update and security response channels not documented.
Documentation 9/20
Evidence: README provides comprehensive install instructions for multiple clients, tool descriptions with parameters, troubleshooting section, and links to external docs. Deductions: Missing cost info, rate-limit details, and API error handling; some limitations not disclosed.
Setup experience 8/20
Evidence: Clear installation steps with config examples for Claude Desktop and Cursor; requires API key and npx. Deductions: No execution evidence (CI/tests) to confirm steps work; config examples may need adjustments; API key omitted by default.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

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.

Setup

Before you start

Runtime：Node.js

OCTAGON_API_KEY requiredsecret API key for the Octagon Market Intelligence API; sign up at https://app.octagonai.co/signup and generate it under the API Keys section of the left menu.
  1. 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"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "octagon-mcp@latest"
      ],
      "env": {
        "OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add octagon-mcp-server -e OCTAGON_API_KEY=YOUR_API_KEY_HERE -- npx -y octagon-mcp@latest

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After configuring the server in Claude Desktop or Cursor, restart the client and check that tools like octagon-agent, octagon-deep-research-agent, and octagon-docs-search appear in the tool list; asking 'What were Amazon's revenue and net income figures in Q4 2023?' should return a cited answer.

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.

Things to try

Once connected, you can ask your AI assistant things like:

  • What were Amazon's revenue and net income figures in Q4 2023?
  • What guidance did NVIDIA's CEO provide regarding AI chip demand in their latest earnings call?
  • Generate a report for the Kalshi market https://kalshi.com/markets/kxbtcy/btc-price-range-eoy/kxbtcy-27jan0100
  • Search Octagon docs for Claude plugin connector setup.

Tools 8

octagon-agent read-only
Orchestrates broad market intelligence analysis.
octagon-deep-research-agent read-only
Performs comprehensive multi-source deep research and synthesis.
octagon-prediction-markets-agent read-only
Generates research reports for Kalshi prediction market events.
prediction_markets_history read-only
Fetches historical data for a prediction market event ticker with optional pagination and time filters.
octagon-docs-search read-only
Searches the Octagon API, agent, MCP, and plugin docs with source URLs and optional snippets.
octagon-docs-read read-only
Reads one docs page or section as Markdown.
octagon-docs-list read-only
Lists live docs sections and pages from the Octagon docs corpus.
octagon-docs-refresh read-only
Refreshes the in-memory docs catalog from live LLM-friendly docs endpoints.

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 Desktop
Cursor

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 653 · Tools 11 Compare with this →
Compare with other MCP servers

Source revision a3234633fbcc Data synced 2026-10-11 Read the FMRS scoring method