Octagon MCP Server


What is this?

Octagon MCP Server is a production-grade implementation of the Model Context Protocol designed for live financial data integration and analytics. It provides large language models and AI agents with a secure, standardized interface to query, ingest, and manipulate real-time market data from equities, indices, cryptocurrencies, and macroeconomic indicators. By abstracting away vendor-specific APIs into a uniform protocol, it simplifies data access and reduces integration overhead.

With Octagon MCP Server, you gain real-time streaming updates, a unified data catalog, extensible analytics modules, and enterprise-grade security features like OAuth2, JWT authentication, and audit logging. Its stateless microservice architecture ensures scalability and low latency, making it ideal for LLM-powered research assistants, automated trading systems, and compliance engines.

Quick Start

Install the server using npm:

npm install @modelcontextprotocol/server-octagon-mcp-server

Then add it to your MCP client configuration:

{
  "mcpServers": {
    "octagon-mcp-server": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-octagon-mcp-server"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Key Features

Real-Time Streaming Data: Continuous, low-latency updates over WebSocket or SSE for equities, crypto, and macro indicators.

Unified Data Access: One protocol interface for multiple data sources without vendor SDK lock-in.

Enterprise Security & Audit: OAuth2/JWT authentication, role-based permissions, and comprehensive audit logging.

Example Usage

Imagine an LLM research assistant fetching the last 30 days of AAPL closing prices and computing a 14-day RSI using the built-in analytics module.

// Example code
const result = await client.callTool({
  name: "rsi_calculator",
  arguments: {
    resource: "equities_daily",
    filters: { ticker: "AAPL" },
    period: 14,
    priceField: "close"
  }
});
console.log("14-day RSI:", result.values);

This code queries the dataset, runs the RSI tool, and logs the indicator values for analysis.

Configuration

The server accepts the following environment variables:

API_KEY – Your access token for authenticating with the MCP server.

SETTING_1 (optional) – Log verbosity level (e.g., DEBUG, INFO).

Available Tools/Resources

Resource Catalog: Discover and browse available financial datasets with schema definitions.

Analytics Tools: Invoke built-in modules like RSI, MACD, chart generators, and compliance rule evaluators.

Who Should Use This?

This server is perfect for:

AI Research Assistants: Quickly query and analyze market data within LLM workflows.

Automated Trading Systems: Execute low-latency trading strategies with real-time feeds.

Compliance & Reporting Engines: Monitor trades and generate audit-trail reports automatically.

Conclusion

Octagon MCP Server streamlines financial data access and analytics for AI-driven applications. Its modular design, live streaming capabilities, and security features make it an indispensable tool for building next-generation trading, research, and compliance solutions. Give it a try and see how quickly you can integrate real-time market insights into your workflows!

Check out the GitHub repository for more information and to contribute.