Historical Financial Ratings

Retrieve historical financial ratings and key metric scores over time using Octagon MCP. Use when analyzing overall ratings, return on assets, return on equity, discounted cash flow scores, debt-to-equity scores, and letter grades (A+, A, B, etc.) for any public company.

132 stars 14 forksFinance & Crypto

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add OctagonAI/skills --skill historical-financial-ratings
Manual install
git clone --depth 1 https://github.com/OctagonAI/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/historical-financial-ratings ~/.claude/skills/historical-financial-ratings

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Historical Financial Ratings

Retrieve and analyze historical financial ratings and key metric scores over time for public companies using the Octagon MCP server.

## Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See [references/mcp-setup.md](references/mcp-setup.md) for installation instructions.

## Workflow

### 1. Identify Analysis Parameters

Determine the following before querying:
- **Ticker**: Stock symbol (e.g., NVDA, AAPL, MSFT)
- **Records**: Number of historical data points to retrieve (e.g., 100, 500, 2000)

### 2. Execute Query via Octagon MCP

Use the `octagon-agent` tool with a natural language prompt:

```
Retrieve historical financial ratings and key metric scores over time for <TICKER>, limited to <N> records.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve historical financial ratings and key metric scores over time for NVDA, limited to 2000 records."
  }
}
```

### 3. Expected Output

The agent returns historical ratings data including:

| Date | Overall Score | Overall Rating | ROA Score | ROE Score | DCF Score | D/E Score |
|------|---------------|----------------|-----------|-----------|-----------|-----------|
| 2024-01-15 | 5 | A+ | 4 | 4 | 3 | 3 |
| 2024-01-08 | 5 | A+ | 4 | 4 | 3 | 3 |
| 2023-12-29 | 5 | A | 4 | 3 | 3 | 3 |
| ... | ... | ... | ... | ... | ... | ... |
Read the full skill on GitHub

Details

Skill name
historical-financial-ratings
Path
skills/historical-financial-ratings/SKILL.md
License
MIT
Repo updated
5 June 2026

FAQ

What does the Historical Financial Ratings skill do?

Retrieve historical financial ratings and key metric scores over time using Octagon MCP. Use when analyzing overall ratings, return on assets, return on equity, discounted cash flow scores, debt-to-equity scores, and letter grades (A+, A, B, etc.) for any public company.

How do I install the Historical Financial Ratings skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add OctagonAI/skills --skill historical-financial-ratings. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Historical Financial Ratings popular?

It lives in OctagonAI/skills, which has 132 GitHub stars and 14 forks.

Related skills

Analyst Estimates

132

OctagonAI/skills

Retrieve analyst financial estimates including Revenue and EPS projections with low/high ranges and analyst coverage. Use when analyzing forward expectations, consensus estimates, valuation inputs, or comparing projections to historical performance.

Finance & Crypto14

Balance Sheet

132

OctagonAI/skills

Retrieve detailed balance sheet statement data including Total Assets, Current Assets, Non-Current Assets, Liabilities, Equity, and Net Debt for public companies. Use when analyzing financial position, capital structure, or leverage metrics.

Finance & Crypto14

Balance Sheet Growth

132

OctagonAI/skills

Retrieve year-over-year growth in balance sheet items including Total Assets, Total Liabilities, Shareholders Equity, Cash, and Inventories. Use when analyzing company financial position trends, capital structure changes, or liquidity management.

Marketing, Sales & Business14

Historical Market Cap

132

OctagonAI/skills

Retrieve historical market capitalization data for any stock using Octagon MCP. Use when tracking market cap changes over time, analyzing valuation trends, identifying peak and trough valuations, and comparing historical size classifications.

Finance & Crypto14

Forex List

132

OctagonAI/skills

Retrieve a full listing of actively traded currency pairs in the global forex market using Octagon MCP. Use when researching forex markets, understanding currency pair categories, analyzing major/minor/exotic pairs, and identifying trading opportunities.

Finance & Crypto14

Income Statement

132

OctagonAI/skills

Retrieve real-time income statement data including Revenue, Net Income, and EPS Diluted for public companies. Use when analyzing absolute financial figures, historical earnings, or comparing company scale across fiscal periods.

Finance & Crypto14

Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.