Skip to main content
skill CX Codex

company-market-cap — Claude Code skill for market cap data

company-market-cap fetches the market capitalization of one publicly traded company through Octagon MCP. Use it to check company size or put a valuation in context.

MIT 266 installs ★ 132 updated 2026-06-05

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OctagonAI/skills --skill company-market-cap -a claude-code
Open on GitHub

What company-market-cap does

The skill sends a ticker or company name to Octagon MCP through the octagon-agent tool. The response includes a dollar value, its as-of date, a rounded figure, and the data source. You can also ask for a peer comparison or a market-cap size category.

Octagon MCP must be configured in your AI agent first. Market capitalization moves with share prices, so check the date attached to each result. It reflects the market’s valuation of shares, not a company’s book value or intrinsic worth.

What it helps with

  • look up a public company’s market cap by ticker
  • compare a company’s market cap with peers
  • classify a company by market-cap size
  • check the date and source behind a market-cap figure

Example prompts for the agent

  • Get the market cap for AAPL and include the as-of date and data source.
  • Compare AMD’s market capitalization with its peers.
  • Classify NVDA by market-cap size.

How to install company-market-cap

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill company-market-cap -a claude-code

2Manually: put the files in place

~/.claude/skills/company-market-cap/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/company-market-cap/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about company-market-cap

How do I install company-market-cap in Claude Code?

Run npx skills add OctagonAI/skills --skill company-market-cap -a claude-code. The skill file is at ~/.claude/skills/company-market-cap/SKILL.md.

What does company-market-cap do?

It retrieves one public company’s market capitalization through Octagon MCP, with the value, as-of date, and data source.

What does the skill need to run?

Configure Octagon MCP in your AI agent. The skill makes its request with the octagon-agent tool.

Source text

SKILL.md · MIT
---
name: company-market-cap
description: Retrieve market capitalization data for a single company using Octagon MCP. Use when you need the current market value, valuation context, or size classification for any publicly traded stock.
---

# 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](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:**

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

| Date | Market 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](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

| Aspect | Description |
|--------|-------------|
| Total Value | Market's valuation of all shares |
| Size Indicator | Company scale and influence |
| Index Weight | Determines index composition |
| Acquisition Cost | Theoretical buyout price |

### What It Doesn't Represent

| Misconception | Reality |
|---------------|---------|
| Intrinsic Value | Market perception, not fundamental worth |
| Book Value | Different from accounting value |
| Enterprise Value | Excludes debt and cash |
| Sale Price | Acquisitions often have premiums |

## Size Classifications

### Standard Categories

| Category | Range | Characteristics |
|----------|-------|-----------------|
| Mega-cap | >$200B | Global leaders, household names |
| Large-cap | $10B-$200B | Established, stable companies |
| Mid-cap | $2B-$10B | Growth potential, moderate risk |
| Small-cap | $300M-$2B | Higher growth, higher volatility |
| Micro-cap | $50M-$300M | Speculative, limited coverage |
| Nano-cap | <$50M | Highest risk, low liquidity |

### Trillion-Dollar Club

| Threshold | Significance |
|-----------|--------------|
| >$1T | Elite status, massive scale |
| >$2T | Global economic influence |
| >$3T | Among world's most valuable |

## Market Cap Analysis

### Valuation Ratios

| Ratio | Formula | Purpose |
|-------|---------|---------|
| P/E | Market Cap / Net Income | Earnings valuation |
| P/S | Market Cap / Revenue | Revenue valuation |
| P/B | Market Cap / Book Value | Asset valuation |
| PEG | P/E / Growth Rate | Growth-adjusted value |

### Enterprise Value Comparison

| Metric | Calculation |
|--------|-------------|
| Enterprise Value | Market Cap + Debt - Cash |
| EV/EBITDA | EV / Operating earnings |
| EV/Revenue | EV / Total revenue |

## Contextual Analysis

### Industry Comparison

| Question | Purpose |
|----------|---------|
| Largest in sector? | Market leadership |
| Above/below median? | Relative positioning |
| Gap to leader? | Distance from top |

### Historical Perspective

| Timeframe | Analysis |
|-----------|----------|
| 1 Year | Recent performance |
| 5 Years | Medium-term trend |
| 10 Years | Long-term growth |
| All-time High | Peak valuation |

### Global Context

| Comparison | Purpose |
|------------|---------|
| vs. Global Leaders | Scale perspective |
| vs. Country GDP | Economic significance |
| vs. Index Total | Market weight |

## Factors Affecting Market Cap

### Price Drivers

| Factor | Impact |
|--------|--------|
| Earnings | Fundamental driver |
| Growth | Future expectations |
| Sentiment | Market psychology |
| Macro | Economic conditions |

### Share Count Changes

| Event | Effect |
|-------|--------|
| Buybacks | Reduces shares, concentrates value |
| Issuance | Increases shares, dilutes |
| Stock Split | No effect (price adjusts) |
| Spin-offs | Separates 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

| Skill | Combined Use |
|-------|--------------|
| stock-quote | Market cap + current price details |
| batch-market-cap | Single company vs. peer group |
| income-statement | Market cap vs. earnings |
| balance-sheet | Market cap vs. book value |
| financial-metrics-analysis | Full valuation analysis |

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
sec-cash-flow-review sec-cash-flow-review extracts cash flow data and working capital changes from SEC filings. Builds trends for operating, investing, and financing cash flows, calculates free cash flow, and evaluates liquidity. CX Codex +1 266installs sec-business-desc-analysis sec-business-desc-analysis — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that pulls business descriptions and competitive landscape data from SEC filings via Octagon MCP. CX Codex +1 266installs balance-sheet-growth balance-sheet-growth fetches year-over-year changes for major balance-sheet lines. Use it to examine liquidity, leverage, assets, equity, cash, and inventories. CX Codex +1 266installs stock-price-change Fetches stock price changes across ten periods — from one day to ten years. Builds a picture of momentum and trends on all horizons. CX Codex +1 266installs earnings-product-pipeline earnings-product-pipeline extracts product development data from earnings calls: clinical trial status, regulatory submissions, launch timelines. CX Codex +1 265installs historical-financial-ratings historical-financial-ratings fetches historical ratings and core financial metric grades for public tickers via Octagon MCP. CX Codex +1 265installs batch-market-cap batch-market-cap — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that pulls market capitalization data for a list of tickers in one call via Octagon MCP. CX Codex +1 265installs stock-performance The stock-performance skill retrieves daily closing prices, trading volumes, and performance metrics via Octagon MCP. Analyze trends, compare stocks, or assess volatility. CX Codex +1 265installs

Project sponsors

Companies that keep this analytics open