home / mcp / octagon mcp server
Provides AI-powered market intelligence by integrating with the Octagon Market Intelligence API for comprehensive research across public filings, earnings, metrics, stock data, and private deals.
Configuration
View docs{
"mcpServers": {
"octagonai-octagon-mcp-server": {
"command": "npx",
"args": [
"-y",
"octagon-mcp@latest"
],
"env": {
"OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}Octagon MCP Server provides AI-powered market research and analysis by connecting to the Octagon Market Intelligence API. It combines data from public filings, earnings calls, financial metrics, stock market data, private market transactions, and more to give you structured insights you can act on within Claude Desktop and other MCP clients.
You use Octagon MCP by running a local MCP server and connecting your MCP client to it. Once connected, you can ask for comprehensive market intelligence, specify the data sources you want to combine, and receive synthesized insights, metrics, and structured data from SEC filings, earnings transcripts, stock data, private deals, and more. Use the dedicated agents to perform deep research, extract key figures, and compare multiple companies or deals in a single session.
Prerequisites: ensure you have Node.js and npm with npx installed.
Install the Octagon MCP server locally using npm via npx. The following runtime command starts the MCP server and passes your API key through the environment.
Configure your MCP client to use Octagon MCP by adding one or more MCP server entries that run locally with npx and the octagon-mcp package. You will provide your API key via an environment variable named OCTAGON_API_KEY.
{
"mcpServers": {
"octagon_claude": {
"command": "npx",
"args": ["-y", "octagon-mcp@latest"],
"env": {
"OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}// Cursor Desktop configuration example
{
"mcpServers": {
"octagon_cursor": {
"command": "env OCTAGON_API_KEY=YOUR_API_KEY_HERE npx -y octagon-mcp",
"args": [],
"env": {
"OCTAGON_API_KEY": "YOUR_API_KEY_HERE"
}
}
}
}# Generic start for Windsurf integration
env OCTAGON_API_KEY=YOUR_API_KEY_HERE npx -y octagon-mcp@latestKeep your API key secure. Do not commit it into public repos or share it. Use a dedicated API key for MCP usage and rotate keys if you suspect exposure.
If you see authentication or connection errors, verify that OCTAGON_API_KEY is set correctly in the environment for the running MCP server. Check that the MCP client is configured to point to the local server and that the server process is running.
Retrieve 5-year revenue growth for AAPL and filter for FY periods.
octagon-agent: Orchestrates market intelligence across SEC filings, earnings calls, financial metrics, stock data, and private market research for comprehensive investment analysis.
Comprehensive market intelligence orchestrator that combines inputs from SEC filings, earnings transcripts, financial metrics, stock data, institutional holdings, and private market research.
Specialized agent for extracting structured financial data from investor relations websites and other public sources when APIs are unavailable.
Deep research agent that aggregates data from multiple sources to provide up-to-date investment research.