mcpField
P
price-target-consensus

price-target-consensus

github.com/octagonaiData & databases130254 installsUpdated 21w ago
Repository

About price-target-consensus

A skill for retrieving and interpreting analyst consensus price targets for a stock through Octagon MCP. It helps investors compare average, median, and range estimates and assess implied upside or downside.

Key features

  1. 01Retrieve average, median, high, and low targets
  2. 02Compare target ranges and analyst views
  3. 03Calculate implied upside and downside
  4. 04Assess target spread and skew

Use cases

  1. 01Check a stock’s valuation against analyst targets
  2. 02Compare price targets across several stocks
  3. 03Review potential downside and target uncertainty

MCP support

Requires Octagon MCP configured in an AI agent and queries the `octagon-agent` tool on `octagon-mcp` for price-target data.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill price-target-consensus

After installing, type/price-target-consensusin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

marketplace.json
README.md
references/
interpreting-results.md
mcp-setup.md

Details

From the project README

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 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:

{
  "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:

MetricValue
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 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
AspectDescription
DefinitionAverage of all analyst targets
CalculationSum of targets / Number of analysts
UseGeneral market expectation
LimitationSkewed by outliers
Median Target
AspectDescription
DefinitionMiddle value of all targets
Calculation50th percentile
UseCentral tendency, outlier-resistant
AdvantageLess affected by extremes
Target High
AspectDescription
DefinitionMost bullish analyst target
RepresentsBest-case scenario
UseMaximum upside potential
CautionMay be overly optimistic
Target Low
AspectDescription
DefinitionMost bearish analyst target
RepresentsWorst-case scenario
UseDownside risk assessment
CautionMay 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:

MetricTargetPotential
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
ScenarioPrefer
Normal distributionConsensus (average)
Outliers presentMedian
Skewed targetsMedian
General expectationConsensus
Identifying Skew
ConditionIndicates
Consensus > MedianRight skew (bullish outliers)
Consensus < MedianLeft skew (bearish outliers)
Consensus ≈ MedianSymmetric 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
TargetRepresents
HighBull case assumptions
LowBear case assumptions
GapRange of outcomes
Scenario Analysis
ScenarioAssumptions
Bull CaseStrong growth, expanding margins, favorable macro
Base CaseConsensus expectations
Bear CaseChallenges, competition, risks materialize

Practical Applications

Investment Decision
FindingConsideration
Price < Low TargetPotential deep value or concerns
Price near ConsensusFairly valued
Price > High TargetPotentially overvalued
Risk Assessment
MetricUse For
Downside to LowWorst-case loss
Upside to HighBest-case gain
Risk/RewardLow upside / High downside
Position Sizing
Consensus ViewPosition Approach
Strong upside, tight rangeLarger position
Moderate upside, wide rangeStandard position
Limited upside, wide rangeSmaller 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

SkillCombined Use
stock-quoteCurrent price for potential calculation
price-target-summaryHistorical target trends
analyst-estimatesEarnings behind the targets
financial-metrics-analysisFundamental validation

Comments

Markdown supported