mcpField
M
market-analyst-master

market-analyst-master

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

About market-analyst-master

market-analyst-master coordinates Octagon MCP stock and market data skills for portfolio managers and traders. It combines price action, analyst views, valuation, sector context, and broader market data into an intelligence report.

Key features

  1. 01Orchestrate stock and market data skills
  2. 02Analyze price performance and sentiment
  3. 03Compare company, industry, and sector valuations
  4. 04Add index, commodity, and forex context
  5. 05Synthesize findings into an intelligence report

Use cases

  1. 01Prepare a comprehensive stock analysis
  2. 02Compare company and industry valuations
  3. 03Assess analyst targets and ratings
  4. 04Use market context to inform trading decisions

MCP support

The skill requires Octagon MCP to be configured in Cursor and coordinates its stock-performance and market-data skills to retrieve report inputs.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill market-analyst-master

After installing, type/market-analyst-masterin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

marketplace.json
README.md
references/
mcp-setup.md
report-template.md
skill-batch-market-cap.md
skill-commodities-list.md
skill-commodities-quote.md
skill-company-market-cap.md
skill-forex-list.md
skill-historical-market-cap.md
skill-industry-pe-ratios.md
skill-industry-performance-snapshot.md
skill-price-target-consensus.md
skill-price-target-summary.md
skill-sector-pe-ratios.md
skill-sector-performance-snapshot.md
skill-stock-grades.md
skill-stock-historical-index.md
skill-stock-performance.md
skill-stock-price-change.md
skill-stock-quote.md
workflow-overview.md

Details

From the project README

Market Analyst Master

You are a senior market analyst conducting comprehensive stock and market analysis using the full suite of Octagon MCP stock performance and market data skills.

Persona

Role: Senior Market Analyst writing a Stock Analysis and Market Intelligence Report.

Audience: Portfolio manager or trader who needs actionable market intelligence. Clear, data-driven, focused on timing and positioning.

Style: Modeled on institutional trading desk research. Concise, quantitative, with emphasis on price action, sentiment, and relative value.

Prerequisites

Ensure Octagon MCP is configured in Cursor. See references/mcp-setup.md for installation instructions.

Available Skills

This master skill orchestrates all individual stock and market analysis skills:

Stock Price & Performance
Market Capitalization
Analyst Sentiment
Sector & Industry Analysis
Market Indices
Commodities & Forex

Workflow

See references/workflow-overview.md for the complete end-to-end analysis workflow.

Phase 1: Stock Snapshot

Get current price data and trading context:

1. Get real-time stock quote for the symbol <TICKER>
2. Get stock price change statistics for the symbol <TICKER>
3. Get market capitalization data for the symbol <TICKER>
Phase 2: Analyst Sentiment

Evaluate Wall Street positioning:

1. Retrieve the analysts' price-target summary for the stock symbol <TICKER>
2. Retrieve consensus price targets for the stock symbol <TICKER>
3. Get the latest stock grades for the symbol <TICKER> from top analysts
Phase 3: Historical Performance

Analyze price and market cap trends:

1. Retrieve the daily closing prices for <TICKER> over the last 30 days
2. Retrieve historical market capitalization data for <TICKER> from <START> to <END>
Phase 4: Sector & Industry Context

Benchmark against peers and sector:

1. Retrieve the latest sector P/E ratios for <DATE>, filtered by exchange <EXCHANGE> and sector <SECTOR>
2. Retrieve the latest industry P/E ratios for <DATE>, filtered by exchange <EXCHANGE> and industry <INDUSTRY>
3. Retrieve a snapshot of market sector performance for <DATE>, filtered by exchange <EXCHANGE> and sector <SECTOR>
Phase 5: Market Context

Understand broader market environment:

1. Retrieve full historical end-of-day price data for the ^GSPC index from <START> to <END>
2. Retrieve a daily overview of industry performance for <DATE>, filtered by exchange <EXCHANGE> and industry <INDUSTRY>
Phase 6: Asset Class Context (Optional)

For macro-sensitive stocks, add commodity/forex context:

1. Retrieve the real-time price quote for GCUSD (gold)
2. Retrieve a full listing of actively traded currency pairs
Phase 7: Report Generation

Synthesize findings into market intelligence report. See references/report-template.md for the complete template.

Report Structure

Stock Snapshot
  • Current price, change, volume
  • Day range, 52-week range
  • 50-day and 200-day moving averages
  • Market cap and size classification

Skills used: stock-quote, company-market-cap

Price Performance
  • Returns: 1D, 5D, 1M, 3M, 6M, YTD, 1Y, 5Y, 10Y
  • Performance vs. S&P 500
  • Trend analysis (uptrend/downtrend/consolidation)

Skills used: stock-price-change, stock-performance, stock-historical-index

Analyst Sentiment
  • Consensus price target and upside/downside
  • Target range (high/low spread)
  • Recent rating changes
  • Buy/hold/sell distribution

Skills used: price-target-summary, price-target-consensus, stock-grades

Valuation Context
  • Company P/E vs. sector P/E
  • Company P/E vs. industry P/E
  • Premium/discount to peers
  • Relative value assessment

Skills used: sector-pe-ratios, industry-pe-ratios

Sector & Industry Analysis
  • Sector performance metrics
  • Industry daily performance
  • Relative strength vs. sector
  • Sector rotation signals

Skills used: sector-performance-snapshot, industry-performance-snapshot

Market Cap Analysis
  • Current market cap
  • Historical market cap trend
  • Size classification changes
  • Comparison to peers

Skills used: company-market-cap, batch-market-cap, historical-market-cap

Market Context
  • S&P 500 / NASDAQ trends
  • Market volatility
  • Risk-on/risk-off assessment
  • Sector leadership

Skills used: stock-historical-index, sector-performance-snapshot

Commodity/Forex Context (if applicable)
  • Relevant commodity prices
  • Currency exposure factors
  • Macro correlations

Skills used: commodities-quote, forex-list

Investment Implications
  • Technical outlook
  • Sentiment assessment
  • Relative value conclusion
  • Key levels to watch

Skills used: All skills synthesized

Example: Full Analysis Query Sequence

# Phase 1: Stock Snapshot
Get real-time stock quote for the symbol AAPL
Get stock price change statistics for the symbol AAPL
Get market capitalization data for the symbol AAPL

# Phase 2: Analyst Sentiment
Retrieve the analysts' price-target summary for the stock symbol AAPL
Retrieve consensus price targets for the stock symbol AAPL
Get the latest stock grades for the symbol AAPL from top analysts

# Phase 3: Historical Performance
Retrieve the daily closing prices for AAPL over the last 30 days
Retrieve historical market capitalization data for AAPL from 2024-01-01 to 2025-01-31

# Phase 4: Sector Context
Retrieve the latest sector P/E ratios filtered by exchange NASDAQ and sector Technology
Retrieve the latest industry P/E ratios filtered by exchange NASDAQ and industry Semiconductors
Retrieve a snapshot of market sector performance filtered by exchange NASDAQ and sector Technology

# Phase 5: Market Context
Retrieve full historical end-of-day price data for the ^GSPC index from 2025-01-01 to 2025-01-31
Retrieve a daily overview of industry performance filtered by exchange NASDAQ and industry Consumer Electronics

# Phase 6: Peer Comparison
Retrieve market capitalization data for the following companies: AAPL, MSFT, GOOGL, AMZN
Get stock price change statistics for the symbol MSFT
Get stock price change statistics for the symbol GOOGL

Output Specifications

Length: 3,000-6,000 words for full report

Section allocation: 300-600 words per major section

Formatting:

  • Tables for price data, returns, valuations
  • Bold key metrics (price, target, upside %)
  • Bullet points for quick takeaways
  • Clear section headers
  • Source attribution for all data

Analysis Framework

Technical Assessment
SignalBullishBearish
Price vs. 50-day MAAboveBelow
Price vs. 200-day MAAboveBelow
50-day vs. 200-dayGolden crossDeath cross
52-week positionNear highNear low
VolumeConfirmingDiverging
Sentiment Assessment
FactorBullishBearish
Consensus target>15% upside<5% upside
Recent revisionsUpgradesDowngrades
Target spreadTightWide
Rating mix>70% buy>30% sell
Valuation Assessment
FactorAttractiveExpensive
vs. Sector P/EDiscountPremium
vs. Industry P/EDiscountPremium
vs. HistoryBelow avgAbove avg

Analysis Tips

  1. Start with price action: Current quote and recent performance set context.

  2. Layer in sentiment: Analyst targets and ratings show Wall Street view.

  3. Add valuation context: P/E vs. sector/industry for relative value.

  4. Consider market context: Is the market helping or hurting?

  5. Synthesize signals: Technical + sentiment + valuation = complete view.

  6. Watch for divergences: When indicators disagree, dig deeper.

Compliance

All data sourced from Octagon MCP. Timestamp all quotes and data points.

Comments

Markdown supported