Skip to main content
skill CX Codex

price-target-consensus — Claude Code skill

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.

MIT 259 installs ★ 132 updated 2026-06-05

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

What price-target-consensus does

The skill connects via Octagon MCP and returns four core metrics: consensus target (mean across all analysts), median (50th percentile), high (most bullish), and low (most bearish). From these you can calculate potential returns or losses as a percentage relative to current price.

It also shows whether analysts broadly agree or split. A narrow range between high and low (under 20% of consensus) signals alignment; a wide spread (over 60%) indicates disagreement. The median is more resistant to outliers if some targets deviate sharply from the rest.

Octagon MCP must be configured in your IDE to use this skill. It works across Claude Code, Cursor, GitHub Copilot, Codex, Gemini CLI, and OpenCode.

What it helps with

  • get average analyst price target for a stock
  • calculate upside or downside from consensus to current price
  • assess analyst agreement by measuring the target range width
  • compare bull and bear case scenarios using high and low targets

Example prompts for the agent

  • What's the consensus price target for AAPL and how much upside does it show?
  • Show me the analyst targets for TSLA: average, median, low, and high
  • Compare consensus targets across AAPL, MSFT, and GOOGL

How to install price-target-consensus

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill price-target-consensus -a claude-code

2Manually: put the files in place

~/.claude/skills/price-target-consensus/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/price-target-consensus/

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

Questions about price-target-consensus

How do I install price-target-consensus in Claude Code?

Run npx skills add OctagonAI/skills --skill price-target-consensus -a claude-code in your terminal, then open ~/.claude/skills/price-target-consensus/SKILL.md.

What does the consensus target mean?

It's the average of all analyst price targets. Think of it as the market's collective view on where a stock should trade.

What setup is required to use this skill?

Octagon MCP needs to be configured in your IDE. Check references/mcp-setup.md for installation steps.

Source text

SKILL.md · MIT
---
name: price-target-consensus
description: Retrieve consensus price targets for any stock using Octagon MCP. Use when you need the average, median, high, and low analyst price targets to evaluate upside/downside potential and analyst agreement.
---

# Price Target Consensus

Retrieve consensus price target metrics including average, median, high, and low targets 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:

```
Retrieve consensus price targets for the stock symbol <TICKER>.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve consensus price targets for the stock symbol AAPL."
  }
}
```

### 3. Expected Output

The agent returns consensus price target data:

| Metric | Value |
|--------|-------|
| Consensus Target | $303.11 |
| Median Target | $315.00 |
| Target High | $350.00 |
| Target Low | $220.00 |

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

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Understanding consensus vs. median
- Analyzing the target range
- Calculating upside/downside
- Evaluating analyst agreement

## Example Queries

**Basic Query:**
```
Retrieve consensus price targets for the stock symbol AAPL.
```

**With Price Context:**
```
What is the consensus price target for TSLA and how does it compare to current price?
```

**Range Focus:**
```
What are the highest and lowest analyst price targets for NVDA?
```

**Comparison:**
```
Compare consensus price targets for AAPL, MSFT, and GOOGL.
```

**Upside Analysis:**
```
What upside does the consensus target imply for AMZN?
```

## Understanding the Metrics

### Consensus Target

| Aspect | Description |
|--------|-------------|
| Definition | Average of all analyst targets |
| Calculation | Sum of targets / Number of analysts |
| Use | General market expectation |
| Limitation | Skewed by outliers |

### Median Target

| Aspect | Description |
|--------|-------------|
| Definition | Middle value of all targets |
| Calculation | 50th percentile |
| Use | Central tendency, outlier-resistant |
| Advantage | Less affected by extremes |

### Target High

| Aspect | Description |
|--------|-------------|
| Definition | Most bullish analyst target |
| Represents | Best-case scenario |
| Use | Maximum upside potential |
| Caution | May be overly optimistic |

### Target Low

| Aspect | Description |
|--------|-------------|
| Definition | Most bearish analyst target |
| Represents | Worst-case scenario |
| Use | Downside risk assessment |
| Caution | May be overly pessimistic |

## Calculating Potential

### Upside/Downside Formulas

```
Consensus Upside = (Consensus Target - Current Price) / Current Price × 100%
Maximum Upside = (Target High - Current Price) / Current Price × 100%
Downside Risk = (Target Low - Current Price) / Current Price × 100%
```

### Example Calculations

If AAPL trades at $270.01:

| Metric | Target | Potential |
|--------|--------|-----------|
| Consensus | $303.11 | +12.3% upside |
| Median | $315.00 | +16.7% upside |
| High | $350.00 | +29.6% upside |
| Low | $220.00 | -18.5% downside |

## Range Analysis

### Spread Calculation

```
Range = Target High - Target Low
Spread % = Range / Consensus Target × 100%
```

### Interpreting Spread

| Spread % | Interpretation |
|----------|----------------|
| <20% | Strong consensus |
| 20-40% | Normal range |
| 40-60% | Moderate disagreement |
| >60% | High uncertainty |

### Example Range Analysis

From AAPL data:
- High: $350.00
- Low: $220.00
- Range: $130.00
- Consensus: $303.11
- Spread: 42.9%

**Interpretation**: Moderate disagreement among analysts, with significant difference between bulls and bears.

## Consensus vs. Median

### When to Use Each

| Scenario | Prefer |
|----------|--------|
| Normal distribution | Consensus (average) |
| Outliers present | Median |
| Skewed targets | Median |
| General expectation | Consensus |

### Identifying Skew

| Condition | Indicates |
|-----------|-----------|
| Consensus > Median | Right skew (bullish outliers) |
| Consensus < Median | Left skew (bearish outliers) |
| Consensus ≈ Median | Symmetric distribution |

### Example

From AAPL data:
- Consensus: $303.11
- Median: $315.00
- Consensus < Median → Left skew (some bearish outliers pulling average down)

## Bull vs. Bear Cases

### Understanding Extremes

| Target | Represents |
|--------|------------|
| High | Bull case assumptions |
| Low | Bear case assumptions |
| Gap | Range of outcomes |

### Scenario Analysis

| Scenario | Assumptions |
|----------|-------------|
| Bull Case | Strong growth, expanding margins, favorable macro |
| Base Case | Consensus expectations |
| Bear Case | Challenges, competition, risks materialize |

## Practical Applications

### Investment Decision

| Finding | Consideration |
|---------|---------------|
| Price < Low Target | Potential deep value or concerns |
| Price near Consensus | Fairly valued |
| Price > High Target | Potentially overvalued |

### Risk Assessment

| Metric | Use For |
|--------|---------|
| Downside to Low | Worst-case loss |
| Upside to High | Best-case gain |
| Risk/Reward | Low upside / High downside |

### Position Sizing

| Consensus View | Position Approach |
|----------------|-------------------|
| Strong upside, tight range | Larger position |
| Moderate upside, wide range | Standard position |
| Limited upside, wide range | Smaller position |

## Common Use Cases

### Quick Valuation Check
```
Is AAPL fairly valued based on analyst targets?
```

### Upside Screening
```
Which tech stocks have the highest consensus upside?
```

### Risk Assessment
```
What's the downside risk to the lowest analyst target for TSLA?
```

### Sentiment Check
```
How wide is the range between bull and bear cases for NVDA?
```

## Analysis Tips

1. **Compare to current price**: Calculate actual upside/downside.

2. **Use median when skewed**: More reliable central tendency.

3. **Analyze the range**: Wide = uncertainty, tight = agreement.

4. **Consider timing**: Targets are typically 12-month forward.

5. **Track changes**: Rising consensus = improving sentiment.

6. **Combine with fundamentals**: Targets are opinions, verify with data.

## Integration with Other Skills

| Skill | Combined Use |
|-------|--------------|
| stock-quote | Current price for potential calculation |
| price-target-summary | Historical target trends |
| analyst-estimates | Earnings behind the targets |
| financial-metrics-analysis | Fundamental validation |

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
ratings-snapshot The ratings-snapshot skill fetches an overall rating and key financial metrics (DCF, ROE, ROA, debt-to-equity, P/E, P/B) for public companies. Use it to screen stocks by fundamentals and compare companies side by side. CX Codex +1 260installs sector-pe-ratios Retrieves sector P/E ratios across stock exchanges using Octagon MCP. Helps compare equity valuations against sector baselines. CX Codex +1 260installs sec-annual-comparison sec-annual-comparison compares financial metrics and risk factors between annual 10-K filings using Octagon MCP. Use it to analyze year-over-year changes in revenue, profitability, risks, and business strategy. CX Codex +1 259installs stock-historical-index stock-historical-index — a skill to fetch full daily price history for market indices via Octagon MCP. Runs when analyzing index performance, calculating returns, and benchmarking individual stocks against the market. 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 stock-grades 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. CX Codex +1 258installs

Project sponsors

Companies that keep this analytics open