Octagon Claude Plugin

The Octagon Claude plugin is a skills-first Claude Code plugin for financial research and prediction market workflows. It packages:

the full Octagon GitHub skills catalog, plus plugin-specific smoke-test coverage
a routing agent for broad analyst workflows
a bundled Octagon MCP runtime for tool execution

This repository is structured as a single-plugin Claude Code marketplace, so it can be used for both local development and marketplace installation.

What It Includes

Core plugin components:

plugin manifest: .claude-plugin/plugin.json
marketplace manifest: .claude-plugin/marketplace.json
bundled MCP config: .claude-plugin/mcp.json
routing agent: agents/octagon-mcp-specialist.md
skills: 67 total
company and financial analysis skills
earnings and transcript analysis skills
SEC filing analysis skills
market data, valuation, and market-cap skills
ESG, sector, industry, commodities, and forex skills
plugin validation via octagon-api-smoke-test

Bundled MCP tools exposed through the runtime:

octagon-agent
octagon-deep-research-agent
octagon-prediction-markets-agent
prediction_markets_history

Installation

Install from a marketplace source

Add this repository as a Claude Code marketplace:

claude plugin marketplace add OctagonAI/octagon-claude-plugin

Then install the plugin:

claude plugin install octagon-claude-plugin@octagon-claude-plugins

Install from a local checkout

For local testing or development:

npm install
npm run build
claude plugin marketplace add "/absolute/path/to/octagon-claude-plugin"
claude plugin install octagon-claude-plugin@octagon-claude-plugins

Configuration

The plugin prompts for:

api_key: required, stored as a sensitive plugin option
api_base_url: optional, defaults to https://api.octagonagents.com/v1

For a local API or staging environment, override api_base_url in the plugin configuration UI.

How It Works

The plugin is skills-first:

users invoke focused financial workflows through Claude skills
the plugin ships the full upstream Octagon skills catalog from OctagonAI/skills
the routing agent can choose the right skill or bundled runtime path
the bundled MCP runtime executes Octagon tool calls behind the scenes

This keeps Claude interactions analyst-oriented while still using typed MCP tools under the hood.

Standalone Runtime Usage

Although this repo is plugin-first, the bundled runtime can still be invoked like a standalone MCP server.

Direct execution:

env OCTAGON_API_KEY=your_octagon_api_key node ./dist/index.js

Global package execution:

npm install -g octagon-claude-plugin
env OCTAGON_API_KEY=your_octagon_api_key npx octagon-claude-plugin

Use this mode only when you specifically want the standalone runtime. For Claude Code, prefer plugin installation.

Documentation

License

MIT

octagon-claude-plugin

Summary

Install to Claude Code