Skip to main content
skill CX Codex

commodities-quote — Claude Code skill: live commodity prices via Octagon MCP

commodities-quote pulls live quotes for metals, energy and agricultural goods through Octagon MCP. Handy when the agent needs a current price or a comparison against the day's range.

MIT 834 installs ★ 132 updated 2026-06-05

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

What commodities-quote does

This skill wires commodity quote requests into your agent through octagon-agent on the octagon-mcp server. A ticker like GCUSD returns the current price, change, day low and high, 50- and 200-day moving averages, 52-week extremes, volume and the previous close.

It ships with ticker tables split by group: precious metals, energy, base metals, agricultural. Gold is GCUSD, WTI crude is CLUSD, natural gas NGUSD, corn ZCUSD. The skill also includes formulas for position inside the daily and yearly range, plus rules for reading moving average patterns — strong uptrend through early downtrend.

Octagon MCP must already be configured in your agent. Without that, the octagon-agent call simply won't run. Data comes from the octagon-stock-data-agent source.

What it helps with

  • get the current gold, silver, oil or gas price by ticker
  • work out where price sits inside the daily range
  • check whether a commodity is above its 200-day average
  • compare several commodity quotes in a single request
  • read volume together with the price move

Example prompts for the agent

  • Get a GCUSD quote and show the day change.
  • Compare current gold, silver and platinum prices through octagon-agent.
  • Work out where CLUSD sits inside its 52-week range.

How to install commodities-quote

1Skills CLI (Vercel)

npx skills add OctagonAI/skills --skill commodities-quote -a claude-code

2Manually: put the files in place

~/.claude/skills/commodities-quote/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/commodities-quote/

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

Questions about commodities-quote

How do I install commodities-quote in Claude Code?

Run npx skills add OctagonAI/skills --skill commodities-quote -a claude-code. The skill lands in ~/.claude/skills/commodities-quote/SKILL.md.

What does commodities-quote do?

It fetches commodity quotes through Octagon MCP: current price, change, daily and yearly ranges, moving averages, volume. Tickers cover precious metals, energy, base metals and agricultural goods.

What does the skill need to work?

Octagon MCP must be set up in your agent — Cursor, Claude Desktop, Windsurf or another. Setup steps are in references/mcp-setup.md inside the skill repository.

Source text

SKILL.md · MIT
---
name: commodities-quote
description: Retrieve real-time commodity price quotes using Octagon MCP. Use when checking current commodity prices, analyzing day ranges, comparing to moving averages, and tracking precious metals, energy, and agricultural commodity prices.
---

# Commodities Quote

Retrieve real-time price quotes for commodities including precious metals, energy, and agricultural products 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 Commodity

Determine the commodity symbol you want to quote:
- **GCUSD**: Gold
- **SIUSD**: Silver
- **CLUSD**: Crude Oil
- **NGUSD**: Natural Gas
- etc.

### 2. Execute Query via Octagon MCP

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

```
Retrieve the real-time price quote for <SYMBOL>.
```

**MCP Call Format:**

```json
{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve the real-time price quote for GCUSD."
  }
}
```

### 3. Expected Output

The agent returns comprehensive quote data:

| Metric | Value |
|--------|-------|
| Current Price | $4,864.20 |
| Change | +$211.60 (+4.55%) |
| Day Low | $4,690.20 |
| Day High | $4,871.00 |
| 50-Day Avg | $4,559.45 |
| 200-Day Avg | $3,888.90 |
| Year Low | $2,837.40 |
| Year High | $5,626.80 |
| Trading Volume | 18,846 |
| Previous Close | $4,652.60 |

**Data Sources**: octagon-stock-data-agent

### 4. Interpret Results

See [references/interpreting-results.md](references/interpreting-results.md) for guidance on:
- Analyzing price movements
- Understanding range positions
- Using moving averages
- Evaluating volume

## Example Queries

**Gold Quote:**
```
Retrieve the real-time price quote for GCUSD.
```

**Silver Quote:**
```
Get the current price for silver (SIUSD).
```

**Crude Oil:**
```
What is the current price of crude oil (CLUSD)?
```

**Natural Gas:**
```
Get the real-time quote for natural gas (NGUSD).
```

**Multiple Commodities:**
```
Compare current prices for gold, silver, and platinum.
```

## Common Commodity Symbols

### Precious Metals

| Symbol | Commodity |
|--------|-----------|
| GCUSD | Gold |
| SIUSD | Silver |
| PLUSD | Platinum |
| PAUSD | Palladium |

### Energy

| Symbol | Commodity |
|--------|-----------|
| CLUSD | Crude Oil (WTI) |
| BZUSD | Brent Crude |
| NGUSD | Natural Gas |
| HOUSD | Heating Oil |
| RBUSD | Gasoline (RBOB) |

### Base Metals

| Symbol | Commodity |
|--------|-----------|
| HGUSD | Copper |
| ALUSD | Aluminum |
| ZNUSD | Zinc |
| NIUSD | Nickel |

### Agricultural

| Symbol | Commodity |
|--------|-----------|
| ZCUSD | Corn |
| ZSUSD | Soybeans |
| ZWUSD | Wheat |
| KCUSD | Coffee |
| SBUSD | Sugar |
| CTUSD | Cotton |

## Understanding Quote Data

### Price Components

| Field | Description |
|-------|-------------|
| Current Price | Latest traded price |
| Change | Dollar change from prior close |
| Change % | Percentage change |
| Previous Close | Prior session close |

### Range Data

| Field | Description |
|-------|-------------|
| Day Low | Lowest price today |
| Day High | Highest price today |
| Year Low | 52-week low |
| Year High | 52-week high |

### Technical Indicators

| Field | Description |
|-------|-------------|
| 50-Day Avg | 50-day moving average |
| 200-Day Avg | 200-day moving average |
| Volume | Contracts/units traded |

## Price Analysis

### Day Range Position

```
Position = (Current - Day Low) / (Day High - Day Low) × 100%
```

### Example

From GCUSD data:
- Current: $4,864.20
- Day Low: $4,690.20
- Day High: $4,871.00
- Position: (4,864.20 - 4,690.20) / (4,871.00 - 4,690.20) = 96.2%

**Interpretation**: Trading near the high of the day (bullish).

### 52-Week Range Position

```
Position = (Current - Year Low) / (Year High - Year Low) × 100%
```

### Example

From GCUSD data:
- Current: $4,864.20
- Year Low: $2,837.40
- Year High: $5,626.80
- Position: (4,864.20 - 2,837.40) / (5,626.80 - 2,837.40) = 72.6%

**Interpretation**: Upper portion of 52-week range.

## Moving Average Analysis

### Price vs. Moving Averages

| Condition | Interpretation |
|-----------|----------------|
| Price > 50-day > 200-day | Strong uptrend |
| Price > 200-day > 50-day | Recovery mode |
| Price < 200-day < 50-day | Starting downtrend |
| Price < 50-day < 200-day | Strong downtrend |

### Example

From GCUSD data:
- Price: $4,864.20
- 50-Day: $4,559.45
- 200-Day: $3,888.90
- Pattern: Price > 50-Day > 200-Day

**Interpretation**: Strong uptrend confirmed by moving averages.

### Golden/Death Cross

| Signal | Condition | Meaning |
|--------|-----------|---------|
| Golden Cross | 50-day crosses above 200-day | Bullish |
| Death Cross | 50-day crosses below 200-day | Bearish |

## Volume Analysis

### Volume Context

| Volume Level | Interpretation |
|--------------|----------------|
| Above average | High interest |
| Average | Normal trading |
| Below average | Low interest |
| Spike | Significant event |

### Volume-Price Relationship

| Combination | Meaning |
|-------------|---------|
| High volume + price up | Strong buying |
| High volume + price down | Strong selling |
| Low volume + price up | Weak rally |
| Low volume + price down | Weak decline |

## Commodity-Specific Factors

### Gold (GCUSD)

| Driver | Impact |
|--------|--------|
| Dollar strength | Inverse relationship |
| Interest rates | Higher rates = lower gold |
| Inflation | Hedge demand |
| Geopolitics | Safe haven flows |

### Crude Oil (CLUSD)

| Driver | Impact |
|--------|--------|
| OPEC decisions | Supply impact |
| Economic growth | Demand driver |
| Inventory data | Weekly catalyst |
| Geopolitics | Supply risk |

### Natural Gas (NGUSD)

| Driver | Impact |
|--------|--------|
| Weather | Heating/cooling demand |
| Storage levels | Supply indicator |
| Production | Shale output |
| LNG exports | Demand shift |

## Common Use Cases

### Price Check
```
What is gold trading at right now?
```

### Trend Analysis
```
Is crude oil above or below its 200-day average?
```

### Range Analysis
```
Where is silver relative to its 52-week range?
```

### Momentum Check
```
Is natural gas showing strength today?
```

### Comparison
```
Compare precious metals prices today.
```

## Analysis Tips

1. **Check the trend**: Price vs. moving averages.

2. **Note the range**: Day range and 52-week range positions.

3. **Consider volume**: Confirms or contradicts price move.

4. **Watch the change %**: Context for daily move.

5. **Compare to peers**: Gold vs. silver, WTI vs. Brent.

6. **Know the drivers**: Fundamental factors for each commodity.

## Integration with Other Skills

| Skill | Combined Use |
|-------|--------------|
| commodities-list | Context on commodity markets |
| stock-historical-index | Broader market context |
| stock-price-change | Compare to equity performance |
| sector-performance-snapshot | Energy sector context |

© OctagonAI · MIT · OctagonAI/skills

Similar skills

All skills for Finance and business →

From the same set67

The whole set →
stock-quote Skill for Claude Code and other AI agents: pulls real-time stock quotes through Octagon MCP. Returns price, volume, market cap, and moving averages for any ticker. CX Codex +1 697installs forex-list forex-list is a Claude Code skill that retrieves actively traded forex pairs through Octagon MCP. It runs for market research and comparisons of major, cross, and exotic pairs. CX Codex +1 535installs market-analyst-master market-analyst-master orchestrates Octagon MCP tools to gather stock quotes, P/E ratios, and analyst consensus targets. It helps traders build structured intelligence reports for individual tickers and sectors. CX Codex +1 422installs financial-metrics-analysis financial-metrics-analysis is a Claude Code skill that fetches year-over-year growth for five income statement metrics at public companies via Octagon MCP. CX Codex +1 369installs commodities-list commodities-list pulls commodity market catalogs across energy, metals, and agriculture alongside active trading firms through Octagon MCP. CX Codex +1 342installs financial-analyst-master financial-analyst-master walks your agent through a full company analysis, from pulling financial statements to a decision-ready report with a rating and target price. CX Codex +1 333installs cash-flow-statement Fetches quarterly and annual cash flow statements for public companies. It tracks free cash flow, operating cash, and capital allocation across historical periods. CX Codex +1 315installs earnings-call-insights earnings-call-insights is a Claude Code skill that reads earnings call transcripts for guidance, management priorities, and market signals. It requires configured Octagon MCP. CX Codex +1 313installs

Project sponsors

Companies that keep this analytics open