Skip to main content
skill CX Codex

stock-grades — Claude Code skill: analyst ratings

stock-grades is a skill that fetches current analyst grades and ratings from major financial institutions. Track rating changes and shifts in market sentiment for any stock.

MIT 258 installs ★ 132 updated 2026-06-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill stock-grades -a claude-code
Open on GitHub

What stock-grades does

The skill connects to Octagon MCP and retrieves analyst ratings by stock ticker. You get rating history with action type (upgrade, downgrade, maintain), source institution, previous and current grade, and date issued. For instance, Maxim Group upgraded from Hold to Buy on January 30.

Inside the skill are reference tables for interpreting rating scales across different banks, a guide to action types (Upgrade, Downgrade, Initiate, Suspend, and others), and methods for spotting significant trends. It helps you distinguish between a meaningful upgrade from Hold to Buy and a routine reaffirmation of an existing rating.

Octagon MCP must be configured in your AI agent for the skill to work. Requests go through octagon-agent using natural language, like "Get the latest stock grades for the symbol AAPL from top analysts and financial institutions."

What it helps with

  • monitor how analyst opinion on a stock shifts over time
  • distinguish a meaningful upgrade from routine rating maintenance
  • compare grades across different banks and institutions
  • spot clusters of upgrades or downgrades that signal catalysts
  • evaluate analyst track record and credibility

Example prompts for the agent

  • Show me the latest analyst grades on AAPL from major institutions
  • Which analysts recently upgraded TSLA and what's their reasoning?
  • How has Goldman Sachs' rating on AMZN evolved over the past year?

How to install stock-grades

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill stock-grades -a claude-code

2Manually: put the files in place

~/.claude/skills/stock-grades/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/stock-grades/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about stock-grades

How do I install stock-grades in Claude Code?

Run npx skills add OctagonAI/skills --skill stock-grades -a claude-code, then open ~/.claude/skills/stock-grades/SKILL.md.

What does stock-grades do?

It queries Octagon MCP for analyst grades and rating history on a given stock, shows which institutions changed ratings and when, and provides context for interpreting market trends.

What's required to use this skill?

Octagon MCP must be installed and configured in your AI agent. Setup instructions are in references/mcp-setup.md in the skill repository.

Source text

SKILL.md · MIT
---
name: stock-grades
description: Retrieve the latest stock grades and ratings from top analysts and financial institutions using Octagon MCP. Use when tracking analyst upgrades, downgrades, rating changes, and institutional sentiment over time.
---

# Stock Grades

Retrieve analyst grades, ratings, and rating changes from top financial institutions 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 the Stock

Determine the ticker symbol for the company you want to analyze (e.g., AAPL, MSFT, GOOGL).

### 2. Execute Query via Octagon MCP

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

```
Get the latest stock grades for the symbol <TICKER> from top analysts and financial institutions.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Get the latest stock grades for the symbol AAPL from top analysts and financial institutions."
  }
}
```

### 3. Expected Output

The agent returns analyst rating history including:

- **Rating Actions**: Upgrades, downgrades, maintains
- **Analyst/Institution**: Source of the rating
- **Previous Rating**: Prior grade
- **New Rating**: Current grade
- **Date**: When the rating was issued

**Example**: Maxim Group upgraded from Hold to Buy on 2026-01-30

**Data Sources**: octagon-stock-data-agent

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding rating scales
- Analyzing upgrade/downgrade trends
- Evaluating analyst credibility
- Tracking sentiment changes

## Example Queries

**Basic Query:**
```
Get the latest stock grades for the symbol AAPL from top analysts and financial institutions.
```

**Recent Changes:**
```
What are the most recent analyst rating changes for TSLA?
```

**Upgrade Focus:**
```
Show me recent upgrades for NVDA from major investment banks.
```

**Historical View:**
```
What is the history of analyst ratings for MSFT over the past year?
```

**Specific Institution:**
```
What is Goldman Sachs' current rating on AMZN?
```

## Understanding Rating Scales

### Common Rating Systems

| Rating Level | Common Terms |
|--------------|--------------|
| Strong Buy | Buy, Overweight, Outperform |
| Buy | Accumulate, Add, Positive |
| Hold | Neutral, Market Perform, Equal-Weight |
| Sell | Underweight, Underperform, Reduce |
| Strong Sell | Sell, Avoid |

### Rating Equivalencies

| Bank A | Bank B | Bank C | Meaning |
|--------|--------|--------|---------|
| Overweight | Buy | Outperform | Bullish |
| Equal-Weight | Hold | Market Perform | Neutral |
| Underweight | Sell | Underperform | Bearish |

## Rating Actions

### Action Types

| Action | Description |
|--------|-------------|
| Upgrade | Rating improved (e.g., Hold → Buy) |
| Downgrade | Rating lowered (e.g., Buy → Hold) |
| Maintain | Rating unchanged (reaffirmed) |
| Initiate | New coverage started |
| Reiterate | Rating repeated with emphasis |
| Resume | Coverage restarted |
| Suspend | Coverage temporarily halted |

### Significance Ranking

| Action | Impact |
|--------|--------|
| Upgrade from Sell | Highest positive |
| Upgrade from Hold | Significant positive |
| Initiate at Buy | Positive |
| Maintain at Buy | Stable positive |
| Downgrade to Hold | Negative signal |
| Downgrade to Sell | Highest negative |

## Analyst Credibility

### Factors to Consider

| Factor | Description |
|--------|-------------|
| Track Record | Historical accuracy |
| Institution Tier | Major bank vs. boutique |
| Sector Expertise | Specialization |
| Coverage Length | Experience with stock |
| Independence | Conflicts of interest |

### Institution Tiers

| Tier | Examples |
|------|----------|
| Bulge Bracket | Goldman Sachs, Morgan Stanley, JPMorgan |
| Major Banks | Bank of America, Citi, UBS |
| Boutiques | Wedbush, Piper Sandler, Needham |
| Independent | Morningstar, CFRA |

## Trend Analysis

### Sentiment Indicators

| Pattern | Interpretation |
|---------|----------------|
| Multiple upgrades | Improving sentiment |
| Multiple downgrades | Deteriorating outlook |
| Mixed actions | Uncertainty/debate |
| All maintains | Stable consensus |

### Momentum Signals

| Signal | Meaning |
|--------|---------|
| Upgrade cluster | Catalyst or breakout |
| Downgrade cluster | Concerns emerging |
| Initiation wave | Growing interest |
| Coverage drops | Reduced attention |

## Rating Distribution

### Consensus Rating

| Distribution | Interpretation |
|--------------|----------------|
| Mostly Buy | Strong bullish consensus |
| Mostly Hold | Neutral/wait-and-see |
| Mostly Sell | Bearish consensus |
| Mixed | Divergent views |

### Rating Counts

| Metric | What It Shows |
|--------|---------------|
| Buy % | Bullish proportion |
| Hold % | Neutral proportion |
| Sell % | Bearish proportion |
| Total Analysts | Coverage level |

## Timing Considerations

### When Ratings Change

| Catalyst | Typical Timing |
|----------|----------------|
| Earnings | Day of or day after |
| Guidance | Within 24-48 hours |
| Product News | Same day |
| Macro Events | As needed |
| Sector Rotation | Periodic |

### Staleness

| Age | Reliability |
|-----|-------------|
| <1 month | Current view |
| 1-3 months | Reasonably current |
| 3-6 months | May be outdated |
| >6 months | Likely stale |

## Common Use Cases

### Sentiment Check
```
What is the current analyst sentiment on AAPL?
```

### Change Monitoring
```
Have any analysts upgraded or downgraded TSLA recently?
```

### Catalyst Research
```
Why did analysts upgrade NVDA last week?
```

### Consensus View
```
What percentage of analysts rate MSFT as a buy?
```

### Historical Tracking
```
How has analyst sentiment on META changed over the past year?
```

## Analysis Tips

1. **Weight by institution**: Major banks carry more weight.

2. **Track changes, not just ratings**: Upgrades/downgrades signal shifts.

3. **Consider timing**: Post-earnings ratings are most current.

4. **Look for clusters**: Multiple changes = significant.

5. **Check track record**: Some analysts are more accurate.

6. **Combine with targets**: Rating + price target = complete view.

## Integration with Other Skills

| Skill | Combined Use |
|-------|--------------|
| price-target-consensus | Ratings + price targets |
| analyst-estimates | Ratings + earnings expectations |
| stock-quote | Rating changes + price reaction |
| stock-performance | Historical ratings vs. performance |

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
price-target-consensus price-target-consensus fetches consensus price targets for any stock: average, median, high and low analyst projections. Use it to evaluate upside potential and measure how widely analysts' views diverge. CX Codex +1 259installs sec-mda-analysis sec-mda-analysis parses MD&A sections from SEC 10-K and 10-Q filings through the Octagon MCP server to track corporate strategy and risks. CX Codex +1 258installs sec-8k-analysis sec-8k-analysis extracts material corporate events and disclosures from SEC 8-K filings using the Octagon MCP server. CX Codex +1 258installs price-target-summary price-target-summary is a skill that retrieves analyst consensus price targets for stocks via Octagon MCP, with trends by month, quarter, year and all time. CX Codex +1 258installs sec-footnotes-analysis The sec-footnotes-analysis skill uses Octagon MCP to analyze footnotes and accounting policies in public-company SEC filings. Ask it about revenue recognition, leases, debt, or management estimates. CX Codex +1 257installs sector-performance-snapshot sector-performance-snapshot is a Claude Code skill that retrieves company financial metrics by sector and exchange via Octagon MCP, supporting industry comparisons. CX Codex +1 257installs sec-debt-covenant The sec-debt-covenant skill examines debt covenants and credit agreement terms in SEC filings. Use it to check leverage limits, maturity schedules, and covenant compliance. CX Codex +1 257installs sec-amendments-review sec-amendments-review is a Claude Code skill that examines SEC filing amendments and surfaces material changes, corrections, and restatements. CX Codex +1 256installs

Project sponsors

Companies that keep this analytics open