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.
Install
npx skills add OctagonAI/skills --skill historical-financial-ratingsgit 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-ratingsPersonal 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 |
| ... | ... | ... | ... | ... | ... | ... |Details
- Skill name
historical-financial-ratings- Repository
- OctagonAI/skills
- 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
132OctagonAI/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.
Balance Sheet
132OctagonAI/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.
Balance Sheet Growth
132OctagonAI/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.
Historical Market Cap
132OctagonAI/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.
Forex List
132OctagonAI/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.
Income Statement
132OctagonAI/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.
Browse the most popular Claude skills, all finance & crypto skills, or write your own with the skills generator.