Octagon MCP Server
Financial market intelligence and prediction data for AI-driven investment analysis.
Data last scanned today · Reviewed today
Overview
The Octagon MCP server connects AI models to the Octagon Market Intelligence API, enabling specialized research across financial domains. It provides tools to extract and synthesize insights from public SEC filings, earnings call transcripts, and comprehensive stocks and crypto market data. Users can leverage dedicated agents for thematic investment research, prediction market analysis, and historical data retrieval. The server also includes full documentation support, allowing users to search, list, and read internal project documentation directly through their MCP-compatible AI interfaces.
Our verdict
With a security score of 61/100, this server is classified as medium risk. The lack of OAuth support necessitates careful management of the required API key. While it benefits from being maintained by the official vendor with regular updates, users should be aware that the server currently lacks a read-only mode, potentially allowing broad access depending on configuration. It is suitable for professional financial analysts and researchers who require integrated market intelligence and can manage their API credentials securely.
- Maintained by the official Octagon AI organization
- Active repository with commits within the last month
- Small footprint with only four direct dependencies
- Comprehensive coverage of public filings and prediction market data
- No read-only operational mode currently available
- Authentication mechanism lacks OAuth support
- Not yet editorially reviewed for security posture
Setup
{
"mcpServers": {
"octagon-mcp-server": {
"args": [
"-y",
"octagon-mcp"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| octagon-docs-list | Lists live docs sections and pages from the Octagon docs corpus. | low |
| octagon-docs-search | Searches the Octagon API, agent, MCP, and plugin docs with source URLs and optional snippets. | low |
| octagon-docs-read | Reads one docs page or section as Markdown by title, URL, path, or catalog id. | low |
| octagon-docs-refresh | Refreshes the in-memory docs catalog from the live LLM-friendly docs endpoints. | low |
| octagon-agent | Orchestrates public and private market intelligence analysis. | low |
| octagon-deep-research-agent | Performs comprehensive multi-source deep research and synthesis. | low |
| octagon-prediction-markets-agent | Generates research reports for Kalshi prediction market events. | low |
| prediction_markets_history | Fetches historical data for a prediction market event ticker with optional pagination and time filters. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What prerequisites are required to run the Octagon MCP server?
You must have Node.js installed on your system, which includes npm and npx.
›How do I obtain an API key for the Octagon MCP server?
You can generate an API key by signing up for a free account on the Octagon platform and navigating to the API Keys section in the left menu.
›Does the documentation access feature require an API key?
No, the documentation tools provided by the server do not use or transmit your OCTAGON_API_KEY.
›What is the minimum Cursor version required to use this MCP server?
Configuring the Octagon MCP server in Cursor requires version 0.45.6 or higher.
›Are there specific configuration instructions for Windows users in Cursor?
If you encounter issues on Windows, use the command 'cmd /c "set OCTAGON_API_KEY=your-octagon-api-key && npx -y octagon-mcp"' to properly set the environment variable.
Badge
Maintain this server? Add the live badge to your README.