mcpField
S
stock-quote

stock-quote

github.com/octagonaiOther130691 installsUpdated 21w ago
Repository

About stock-quote

stock-quote is a skill for querying stock quotes through the Octagon MCP server. It helps users of configured AI agents retrieve current price, trading ranges, volume, market capitalization, exchange, and moving averages.

Key features

  1. 01Current prices and price changes
  2. 02Volume and trading ranges
  3. 03Market capitalization and exchange
  4. 0450-day and 200-day averages
  5. 05Natural-language quote queries

Use cases

  1. 01Checking a ticker’s current price
  2. 02Monitoring quotes for several holdings
  3. 03Comparing price with moving averages
  4. 04Reviewing a stock’s 52-week range

MCP support

It uses the Octagon MCP server’s octagon-agent tool to request stock quote data. The MCP server returns quote metrics for the requested ticker or tickers.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill stock-quote

After installing, type/stock-quotein 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

Stock Quote

Retrieve real-time stock quotes with current price, volume, day range, 52-week range, market cap, and moving averages 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 stock you want to quote (e.g., AAPL, MSFT, GOOGL).

2. Execute Query via Octagon MCP

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

Get real-time stock quote for the symbol <TICKER>.

MCP Call Format:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Get real-time stock quote for the symbol AAPL."
  }
}
3. Expected Output

The agent returns a comprehensive quote including:

MetricExample Value
Current Price$270.01
Change+$10.53 (+4.06%)
Volume72,890,096 shares
Day Range$259.21 - $270.48
52-Week Range$169.21 - $288.62
Market Cap$3.97 trillion
ExchangeNASDAQ
Previous Close$259.48
50-Day Average$268.30
200-Day Average$236.65

Data Sources: octagon-stock-data-agent

4. Interpret Results

See references/interpreting-results.md for guidance on:

  • Understanding price movements
  • Evaluating volume significance
  • Analyzing range positions
  • Using moving averages

Example Queries

Basic Quote:

Get real-time stock quote for the symbol AAPL.

Multiple Stocks:

Get stock quotes for AAPL, MSFT, and GOOGL.

Specific Metrics:

What is the current price and market cap for TSLA?

Range Analysis:

Where is NVDA trading relative to its 52-week range?

Moving Averages:

What are the 50-day and 200-day moving averages for AMZN?

Key Quote Components

Price Information
ComponentDescription
Current PriceLast traded price
ChangeDollar change from previous close
Percent ChangePercentage change from previous close
Previous ClosePrior day's closing price
Volume Data
ComponentDescription
VolumeShares traded today
Average VolumeTypical daily volume
Relative VolumeCurrent vs. average
Range Data
ComponentDescription
Day HighHighest price today
Day LowLowest price today
52-Week HighHighest price in past year
52-Week LowLowest price in past year
Market Data
ComponentDescription
Market CapTotal market value
ExchangeTrading venue (NASDAQ, NYSE, etc.)
Shares OutstandingTotal shares issued
Technical Indicators
ComponentDescription
50-Day MA50-day moving average
200-Day MA200-day moving average
Golden Cross50-day crosses above 200-day
Death Cross50-day crosses below 200-day

Quote Analysis Framework

Price Position Analysis
PositionInterpretation
Near 52-Week HighStrong momentum, potential resistance
Near 52-Week LowWeakness, potential support
Mid-RangeNeutral, watch for direction
Above Moving AveragesBullish trend
Below Moving AveragesBearish trend
Volume Analysis
Volume LevelInterpretation
Above AverageHigh interest, confirming move
Below AverageLow conviction
SpikeUnusual activity, catalyst likely
Moving Average Signals
SignalConditionInterpretation
Golden Cross50-day > 200-dayBullish
Death Cross50-day < 200-dayBearish
Price > Both MAsAbove both averagesStrong uptrend
Price < Both MAsBelow both averagesStrong downtrend

Market Context

Trading Hours
SessionTime (ET)
Pre-Market4:00 AM - 9:30 AM
Regular9:30 AM - 4:00 PM
After-Hours4:00 PM - 8:00 PM
Quote Timing
WhenData Reflects
Market HoursReal-time or 15-min delay
Pre/After HoursExtended hours trading
Closed MarketPrevious close

Common Use Cases

Quick Price Check
What is AAPL trading at right now?
Portfolio Monitoring
Get quotes for my holdings: AAPL, MSFT, GOOGL, AMZN, META.
Valuation Context
What is the market cap of NVDA?
Technical Analysis
Is TSLA trading above or below its 200-day moving average?
Range Analysis
How close is AMZN to its 52-week high?

Analysis Tips

  1. Compare to averages: Price vs. 50-day and 200-day MA shows trend.

  2. Check volume: High volume confirms price moves.

  3. Range position: Near highs = strength, near lows = weakness.

  4. Market cap context: Larger caps typically less volatile.

  5. Time of day: Opening and closing often most volatile.

  6. Pre/post market: Less liquidity, wider spreads.

Integration with Other Skills

SkillCombined Use
stock-performanceCurrent quote + historical context
financial-metrics-analysisQuote + fundamental valuation
income-statementPrice vs. earnings relationship
analyst-estimatesQuote vs. price targets

Comments

Markdown supported