Log inSubmit server
Octagon MCP Server logo

Octagon MCP Server

by OctagonAI

Connects MCP clients to Octagon's public, private, and prediction-market intelligence and live documentation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Octagon MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "octagonai-octagon-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "octagon-mcp"
      ],
      "env": {
        "OCTAGON_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

OctagonAI/octagon-mcp-server MCP server connects MCP clients to Octagon Market Intelligence for research across public filings, earnings calls, financial metrics, stocks, crypto, news, and prediction markets. It runs locally over stdio through npx and uses an OCTAGON_API_KEY for Octagon intelligence features. Documentation tools can list, search, read, and refresh Octagon's live documentation corpus without an API key. Reach for it when an agent needs financial research or prediction-market analysis rather than general-purpose market data access.

Use cases

  • Research public-company filings and earnings calls
  • Analyze stock, crypto, and financial news data
  • Investigate prediction markets and retrieve historical prices
  • Search Octagon documentation from an MCP client

Key features

  • Public and private market intelligence research
  • Prediction-market reports and historical data
  • SEC filing and earnings-call analysis
  • Live Octagon documentation search and retrieval
  • MCP resources for documentation catalogs and pages

Tools6

What Octagon MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~33 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · octagon-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars147Stargazers on the source repository.
npm downloads887Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Tools exposed6Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Octagon MCP Server works

What OctagonAI/octagon-mcp-server MCP server does

OctagonAI/octagon-mcp-server MCP server exposes Octagon's market-intelligence workflows to MCP-compatible clients. Its research coverage includes SEC filings such as 10-K, 10-Q, 20-F, 8-K, S-1, 13-F, and DEF 14A; earnings-call transcripts; stock and crypto data; financial news; press releases; ownership and holdings; and prediction-market research.

The server also makes Octagon's documentation available inside the MCP session. Clients can browse the documentation catalog, search for setup or API guidance, read a page as Markdown, and refresh the in-memory catalog from Octagon's live documentation endpoints.

How it works

The package currently runs as a local stdio MCP server. An MCP client starts it with npx, and the server communicates with the client through the local process. Market research requests are sent to the Octagon Market Intelligence API using the configured API key.

The prediction-market agent returns updated research reports for prediction markets, while prediction_markets_history retrieves structured historical market data. The market-intelligence agent accepts natural-language research prompts and supports conversation continuity through Octagon conversation IDs and server-managed session state.

Documentation tools use Octagon's public LLM-friendly documentation endpoints. They do not use or transmit OCTAGON_API_KEY, so documentation lookup is available before the market API credentials are configured. MCP clients that support resources can also access the catalog, status information, and individual documentation pages through Octagon documentation resource URIs.

Setup and configuration

To use the OctagonAI/octagon-mcp-server MCP server for market intelligence, create an Octagon account, generate an API key from the API Keys area, and provide it as OCTAGON_API_KEY. Node.js and npm are prerequisites because the documented setup uses npx.

A Claude Desktop configuration starts the server with npx -y octagon-mcp@latest and places the API key in the server's environment. The package can alternatively be installed globally with npm.

Tools and capabilities

The documented tools include:

  • octagon-prediction-markets-agent for current prediction-market research reports.
  • prediction_markets_history for structured historical prediction-market data.
  • octagon-docs-list to enumerate documentation pages and sections.
  • octagon-docs-search to search Octagon API, agent, MCP, and plugin documentation.
  • octagon-docs-read to retrieve a page or section as Markdown.
  • octagon-docs-refresh to reload the documentation catalog, optionally including the broader site index.

Limitations and notes

The OctagonAI/octagon-mcp-server MCP server requires an Octagon API key for its market-intelligence functionality, although the documentation tools work without one. Research results depend on Octagon's API and data coverage.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Octagon MCP Server

Install Node.js and npm, then run it with `npx -y octagon-mcp@latest`.

Market-intelligence features require an Octagon API key provided through the `OCTAGON_API_KEY` environment variable. Documentation tools do not require this key.

Yes. The README provides a Claude Desktop configuration using the local npx stdio command and `OCTAGON_API_KEY`.

Yes. Cursor Desktop version 0.45.6 or newer is documented, using a command configuration with `npx -y octagon-mcp` and the Octagon API key.

Yes. The server provides documentation list, search, read, and refresh tools, along with MCP resources for the catalog, status, and individual pages.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOctagon MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/octagonai-octagon-mcp-server?style=directory)](https://allmcps.com/mcp/octagonai-octagon-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/octagonai-octagon-mcp-server"><img src="https://allmcps.com/api/badge/octagonai-octagon-mcp-server?style=directory" alt="Octagon MCP Server on AllMCPs" /></a>