mcpField
C
company-market-cap

company-market-cap

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

About company-market-cap

A skill that retrieves the current market capitalization for one company through Octagon MCP. It is intended for financial research and provides dated values with context for interpreting company size and valuation.

Key features

  1. 01Market cap lookup by ticker
  2. 02As-of date and data source
  3. 03Rounded and precise values
  4. 04Guidance for interpreting market cap

Use cases

  1. 01Check a company’s market value
  2. 02Add size context to portfolio holdings
  3. 03Review valuation in peer comparisons

MCP support

Uses the octagon-agent tool on the octagon-mcp server to query market capitalization data for a company.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/octagonai/skills --skill company-market-cap

After installing, type/company-market-capin 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

Company Market Cap

Retrieve the current market capitalization for a single company 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:

Get market capitalization data for the symbol <TICKER>.

MCP Call Format:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Get market capitalization data for the symbol AAPL."
  }
}
3. Expected Output

The agent returns precise market cap data:

DateMarket Capitalization (USD)
2026-02-02$3,968,586,877,215.00

Additional context provided:

  • Rounded value (e.g., $3.97 trillion)
  • As-of date for the data
  • Data source

Data Sources: octagon-stock-data-agent

4. Interpret Results

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

  • Understanding market cap magnitude
  • Size classification
  • Valuation context
  • Historical comparison

Example Queries

Basic Query:

Get market capitalization data for the symbol AAPL.

With Context:

What is the current market cap for Tesla?

Historical Reference:

What is Microsoft's market capitalization and how has it changed recently?

Valuation Context:

What is NVDA's market cap and how does it compare to other chipmakers?

Size Classification:

What size category is AMD based on its market cap?

Understanding Market Cap

Definition
Market Cap = Current Share Price × Shares Outstanding
What It Represents
AspectDescription
Total ValueMarket's valuation of all shares
Size IndicatorCompany scale and influence
Index WeightDetermines index composition
Acquisition CostTheoretical buyout price
What It Doesn't Represent
MisconceptionReality
Intrinsic ValueMarket perception, not fundamental worth
Book ValueDifferent from accounting value
Enterprise ValueExcludes debt and cash
Sale PriceAcquisitions often have premiums

Size Classifications

Standard Categories
CategoryRangeCharacteristics
Mega-cap>$200BGlobal leaders, household names
Large-cap$10B-$200BEstablished, stable companies
Mid-cap$2B-$10BGrowth potential, moderate risk
Small-cap$300M-$2BHigher growth, higher volatility
Micro-cap$50M-$300MSpeculative, limited coverage
Nano-cap<$50MHighest risk, low liquidity
Trillion-Dollar Club
ThresholdSignificance
>$1TElite status, massive scale
>$2TGlobal economic influence
>$3TAmong world's most valuable

Market Cap Analysis

Valuation Ratios
RatioFormulaPurpose
P/EMarket Cap / Net IncomeEarnings valuation
P/SMarket Cap / RevenueRevenue valuation
P/BMarket Cap / Book ValueAsset valuation
PEGP/E / Growth RateGrowth-adjusted value
Enterprise Value Comparison
MetricCalculation
Enterprise ValueMarket Cap + Debt - Cash
EV/EBITDAEV / Operating earnings
EV/RevenueEV / Total revenue

Contextual Analysis

Industry Comparison
QuestionPurpose
Largest in sector?Market leadership
Above/below median?Relative positioning
Gap to leader?Distance from top
Historical Perspective
TimeframeAnalysis
1 YearRecent performance
5 YearsMedium-term trend
10 YearsLong-term growth
All-time HighPeak valuation
Global Context
ComparisonPurpose
vs. Global LeadersScale perspective
vs. Country GDPEconomic significance
vs. Index TotalMarket weight

Factors Affecting Market Cap

Price Drivers
FactorImpact
EarningsFundamental driver
GrowthFuture expectations
SentimentMarket psychology
MacroEconomic conditions
Share Count Changes
EventEffect
BuybacksReduces shares, concentrates value
IssuanceIncreases shares, dilutes
Stock SplitNo effect (price adjusts)
Spin-offsSeparates value

Common Use Cases

Investment Analysis
What is the market cap for XYZ and how does it compare to peers?
Portfolio Context
What is the market capitalization of my largest holding, AAPL?
News Context
Apple's market cap after today's earnings announcement?
Valuation Check
Is TSLA's market cap justified relative to its revenue?

Analysis Tips

  1. Use precise values: Full number for calculations, rounded for communication.

  2. Note the date: Market cap changes constantly with price.

  3. Consider float: Some shares may not be tradeable.

  4. Compare appropriately: Same industry, similar business models.

  5. Understand drivers: Price appreciation vs. share changes.

  6. Enterprise value: Add debt consideration for M&A context.

Integration with Other Skills

SkillCombined Use
stock-quoteMarket cap + current price details
batch-market-capSingle company vs. peer group
income-statementMarket cap vs. earnings
balance-sheetMarket cap vs. book value
financial-metrics-analysisFull valuation analysis

Comments

Markdown supported