octagonai/commodities-quote
skills/commodities-quote/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add octagonai/skills commodities-quoteInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 6, 2026, 7:01 AM141.1s5 files scanned
SKILL.md
- 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 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:
{
"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 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
-
Check the trend: Price vs. moving averages.
-
Note the range: Day range and 52-week range positions.
-
Consider volume: Confirms or contradicts price move.
-
Watch the change %: Context for daily move.
-
Compare to peers: Gold vs. silver, WTI vs. Brent.
-
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 |
Related Skills
octagonai/earnings-call-analysis
data-ai
VerifiedTrustedCommunity
Analyze earnings call transcripts to extract forward-looking guidance, strategic focus areas, supply chain insights, and generate follow-up questions for deeper analysis.
117SKILL.mdUpdated Jun 6, 2026
octagonai/earnings-analyst-questions
development
VerifiedTrustedCommunity
Identify key themes and concerns raised by analysts during earnings calls, including specific analyst attribution and topic categorization.
117SKILL.mdUpdated Jun 6, 2026
octagonai/earnings-analyst-master
development
VerifiedTrustedCommunity
Comprehensive earnings call analyst skill that orchestrates all Octagon earnings analysis skills. Use when analyzing earnings calls, extracting management insights, tracking guidance, and creating earnings-focused research reports.
117SKILL.mdUpdated Jun 6, 2026
octagonai/company-market-cap
tools
VerifiedTrustedCommunity
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.
117SKILL.mdUpdated Jun 6, 2026