batch-market-cap

Retrieve market capitalization data for multiple companies at once using Octagon MCP. Use when comparing valuations across peers, screening by market cap, or analyzing a portfolio's composition by company size.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "batch-market-cap" with this command: npx skills add octagonai/skills/octagonai-skills-batch-market-cap

Batch Market Cap

Retrieve market capitalization data for multiple companies in a single query 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. Prepare Company List

Compile the list of ticker symbols 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 market capitalization data for the following companies: <TICKER1>, <TICKER2>, <TICKER3>.

MCP Call Format:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve market capitalization data for the following companies: AAPL, MSFT, GOOG."
  }
}

3. Expected Output

The agent returns a structured table with market cap data:

CompanyTickerMarket Cap (USD)Source
AppleAAPL$2.99986 trillionOctagon Companies Agent
MicrosoftMSFT$3.143 trillionCompanies Market Cap
AlphabetGOOGL$2.00018 trillionOctagon Companies Agent

Data Sources: octagon-companies-agent, octagon-financials-agent, octagon-web-search-agent

4. Interpret Results

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

  • Comparing market caps across companies
  • Understanding size categories
  • Analyzing relative valuations
  • Tracking market cap changes

Example Queries

Basic Batch Query:

Retrieve market capitalization data for the following companies: AAPL, MSFT, GOOG.

Sector Comparison:

Get market caps for tech giants: AAPL, MSFT, GOOGL, AMZN, META, NVDA.

Portfolio Analysis:

What are the market capitalizations of TSLA, F, GM, and RIVN?

Industry Comparison:

Compare market caps of major banks: JPM, BAC, WFC, C, GS.

Index Components:

Get market caps for the top 10 S&P 500 companies by weight.

International Comparison:

Compare market caps of AAPL, SMSN.IL (Samsung), TSM, and ASML.

Market Cap Categories

Size Classifications

CategoryMarket Cap Range
Mega-cap>$200 billion
Large-cap$10B - $200B
Mid-cap$2B - $10B
Small-cap$300M - $2B
Micro-cap$50M - $300M
Nano-cap<$50M

Category Characteristics

CategoryTypical Traits
Mega-capMarket leaders, global reach, stable
Large-capEstablished, diversified, moderate growth
Mid-capGrowth potential, less coverage
Small-capHigher growth, higher volatility
Micro-capSpeculative, limited liquidity

Comparative Analysis Framework

Peer Comparison

AnalysisPurpose
Absolute SizeRank by market cap
Relative SizeRatio to peers
Size DistributionConcentration analysis
Historical RankPosition changes

Industry Context

ComparisonWhat It Shows
vs. Industry LeaderDistance from top
vs. Industry MedianAbove/below average
vs. Sector TotalMarket share proxy

Valuation Implications

ScenarioInterpretation
Higher market cap, lower revenuePremium valuation
Lower market cap, higher revenueDiscount valuation
Similar market cap, different earningsP/E differential

Use Cases

Portfolio Allocation

UseDescription
Concentration AnalysisLargest holdings by cap
Diversification CheckSize mix across holdings
RebalancingAdjust for cap changes

Competitive Analysis

UseDescription
Market LeadershipLargest in industry
Relative PositioningSize vs. competitors
Growth ComparisonCap changes over time

Screening

UseDescription
Size FilterInclude/exclude by cap
Category SelectionTarget specific sizes
Index EligibilityMeets cap requirements

Market Cap Calculations

Basic Formula

Market Cap = Share Price × Shares Outstanding

Factors Affecting Market Cap

FactorImpact
Price ChangeDirect proportional effect
Share BuybacksReduces shares, concentrates value
New IssuanceDilutes if price doesn't rise
Stock SplitsNo effect (price adjusts)

Fully Diluted Market Cap

ComponentDescription
Basic SharesCurrently outstanding
OptionsEmployee stock options
WarrantsConvertible instruments
ConvertiblesConvertible debt/preferred

Data Considerations

Source Variations

FactorConsideration
TimingReal-time vs. delayed data
CurrencyUSD conversion rates
Share CountBasic vs. diluted
UpdatesFrequency of refresh

Handling Discrepancies

IssueApproach
Different sourcesNote the variance
Different datesUse consistent timing
Currency mixConvert to single currency
Missing dataFlag unavailable items

Analysis Tips

  1. Use consistent data: Same source/date for fair comparison.

  2. Consider context: Industry norms for market cap.

  3. Track changes: Market cap shifts over time.

  4. Combine with fundamentals: P/E, P/S for valuation context.

  5. Watch for outliers: Investigate unusual sizes.

  6. Global perspective: Different markets, different scales.

Integration with Other Skills

SkillCombined Use
stock-quoteMarket cap + current price
income-statementMarket cap vs. revenue/earnings
financial-metrics-analysisValuation multiples
analyst-estimatesMarket cap vs. price targets

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

commodities-quote

No summary provided by upstream source.

Repository SourceNeeds Review
General

stock-quote

No summary provided by upstream source.

Repository SourceNeeds Review
General

forex-list

No summary provided by upstream source.

Repository SourceNeeds Review
General

market-analyst-master

No summary provided by upstream source.

Repository SourceNeeds Review