# Commodities MCP MCP

> Commodities MCP provides instant access to real-time futures prices for over 30 global commodities. Track gold, oil, natural gas, wheat, copper, and more across energy, metals, and agriculture using a single connection. Get market intelligence on precious metals, industrial raw materials, and food staples.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** commodity-prices, futures-market, precious-metals, energy-data, real-time-api, market-intelligence

## Description

This MCP connects your AI agent directly to a massive stream of real-time futures market data. You stop guessing about commodity prices and start acting on facts. Whether you're tracking the volatility of gold or needing the current price for WTI crude oil, everything is available instantly.

Your agent can pull specific quotes—like checking the latest wheat futures or getting a full snapshot of energy markets including Brent and natural gas. It can also compare multiple commodities at once, letting you see how silver prices move relative to gold. This capability makes your AI feel like an actual commodity analyst on retainer.

Because this data is housed within Vinkius's MCP catalog, you connect once from any compatible client, giving your agent access to the entire breadth of financial market tools. It’s raw, structured data that lets you understand complex market dynamics and make decisions based purely on current pricing.

## Tools

### get_agriculture_commodities_prices
Gets current futures prices for major food and farming commodities like wheat, corn, and coffee.

### get_brent_crude_oil_price
Retrieves the international benchmark price for Brent crude oil.

### get_coffee_price
Provides the current futures market price for coffee beans globally.

### get_copper_price
Delivers the latest futures price data for copper, an industrial metal.

### get_crude_oil_price
Checks the current US benchmark price for West Texas Intermediate (WTI) crude oil.

### get_energy_commodities_prices
Returns a combined view of prices for key energy sources, including crude oil and natural gas.

### get_gold_price
Fetches the immediate futures price for gold bullion.

### list_all_commodities
Lists every available commodity, its code, and which exchange it trades on.

### get_natural_gas_price
Provides the current market price for natural gas, a key energy source.

### get_precious_metals_prices
Lists up-to-date futures prices for all major precious metals: gold, silver, platinum, and palladium.

### get_silver_price
Gets the current futures market price specifically for silver.

### get_wheat_price
Retrieves the latest futures price data for wheat.

## Prompt Examples

**Prompt:** 
```
What is the current price of gold?
```

**Response:** 
```
Fetching gold futures price... Current gold is trading at $2,685.40 USD per troy ounce on CME. The price was last updated 3 minutes ago. Gold has been holding steady near all-time highs as investors seek safe-haven assets.
```

**Prompt:** 
```
Show me energy commodity prices — oil and natural gas.
```

**Response:** 
```
Retrieving energy futures prices... WTI Crude Oil: $78.45/bbl (NYMEX), Brent Crude: $82.30/bbl (CME), Natural Gas: $2.85/MMBtu (NYMEX). The WTI-Brent spread is $3.85. Energy markets are balanced with moderate demand and steady supply.
```

**Prompt:** 
```
What are the current agriculture commodity prices for wheat, coffee, and cocoa?
```

**Response:** 
```
Fetching agriculture futures... Wheat: $6.15/bushel (CBOT), Coffee: $1.85/lb (CME), Cocoa: $3,250/ton (CME). Cocoa prices have been elevated due to supply constraints from West Africa. Wheat and coffee are trading in normal ranges.
```

## Capabilities

### Get specific commodity prices
Fetch the immediate futures price for a single item, like gold or copper.

### Track entire market sectors
Retrieve current pricing across large groups of goods, such as all major energy commodities or precious metals.

### Compare multiple assets
Pull and compare the prices of several different commodities in a single request.

### List all available data points
View every commodity code, category, and exchange that the API tracks.

## Use Cases

### Evaluating investment risk
A portfolio manager needs to know how interconnected different markets are. They ask their agent, 'Compare gold prices with WTI crude oil and natural gas.' The agent uses `get_gold_price`, `get_crude_oil_price`, and `get_natural_gas_price` to provide a single comparative report.

### Optimizing supply chain timing
A manufacturing company needs to buy copper wiring and aluminum parts. They ask their agent for the latest industrial metal prices, running two separate checks using `get_copper_price` and also checking general precious metals with `get_precious_metals_prices`.

### Agricultural planning after a storm
A farm cooperative needs to know if their crops are stable. They ask for current pricing on multiple grains, triggering the agent to use `get_agriculture_commodities_prices` to check wheat, corn, and soybean prices simultaneously.

### Responding to geopolitical news
A hedge fund analyst needs immediate data after a major political announcement. They ask for the current status of 'safe-haven assets,' prompting the agent to use `get_gold_price` and compare it against stable industrial metals using `get_copper_price`.

## Benefits

- Know the difference between specific quotes and market snapshots. You can check a single commodity price using `get_coffee_price`, or grab an entire sector view by calling `get_energy_commodities_prices`.
- Stop managing dozens of separate data feeds. The MCP lets you compare metals (gold, copper) alongside energy (oil, gas) in one workflow, giving a true picture of market health.
- When planning inventory or investment, you can pull all necessary data points at once by running `get_precious_metals_prices`, ensuring you don't miss any major asset class.
- Need to know what other data is available? Use the `list_all_commodities` tool. It lists every commodity code and exchange (CME, NYMEX) so your agent knows exactly what to query next.
- You can run a full market comparison by pulling multiple quotes in sequence, for example checking both `get_wheat_price` and `get_natural_gas_price` to gauge global supply pressures.

## How It Works

The bottom line is your AI client gets live market quotes without needing any external database lookup or manual API keys.

1. Connect your preferred AI client to this Commodities MCP via Vinkius.
2. Ask your agent for a specific price, like 'What is the current copper futures price?'
3. The agent calls the appropriate tool and returns the real-time pricing data directly into the chat or workflow.

## Frequently Asked Questions

**What commodities are available and which exchanges trade them?**
The API offers 30+ commodities across 5 categories: Precious Metals (gold, silver, platinum, palladium on CME/NYMEX), Energy (WTI crude, Brent crude, natural gas on NYMEX/CME), Agriculture (wheat, corn, soybean, coffee, cocoa, sugar, cotton on CBOT/CME), Livestock (live cattle, feeder cattle, lean hogs, Class III milk on CME), and Industrial Metals (copper, aluminum on CME). Use the `list_all_commodities` tool to see the complete catalog.

**How do I get a Commodities-API key and what are the usage limits?**
Visit https://www.omkar.cloud/api-key and sign up for a free account. The free tier includes 5,000 API requests per month. Paid plans start at $25/month for 100,000 requests. Rate limit on free tier: requests are counted monthly. After exceeding your limit, you'll receive HTTP 429 errors.

**Are these real-time prices or delayed?**
The API provides near real-time futures prices that are updated periodically throughout trading hours. Prices reflect the latest available futures contract data from CME, NYMEX, and CBOT exchanges. During market hours, updates are frequent. Outside trading hours, prices reflect the last traded values. Each price response includes an `updated_at` timestamp showing when the data was last refreshed.

**Can I get prices for multiple commodities at once?**
Yes! Use the specialized tools `get_precious_metals_prices`, `get_energy_commodities_prices`, or `get_agriculture_commodities_prices` to fetch multiple related commodities in a single call. You can also call individual commodity tools like `get_gold_price`, `get_crude_oil_price`, etc. for specific quotes. Each tool is designed to give you the most relevant prices for that market segment.

**When I call `list_all_commodities`, what specific metadata do I get for each commodity?**
The tool lists all supported commodities along with their associated codes and primary exchanges. This is essential because the data you pull later, like using `get_wheat_price`, requires the correct code to function properly.

**How should I use both `get_crude_oil_price` and `get_brent_crude_oil_price`?**
You use these two tools when you need a full global picture of oil pricing. Remember that `get_crude_oil_price` tracks the US benchmark (WTI), while `get_brent_crude_oil_price` covers international benchmarks.

**What kind of insight does running `get_copper_price` give an analyst?**
The copper data serves as a critical industrial benchmark, often called 'Dr. Copper.' By tracking this price, you get a key indicator used to gauge the overall health and economic stability of global markets.

**Does running `get_natural_gas_price` provide context for broader energy market analysis?**
Yes. Natural gas is a major component of the energy sector, needed alongside oil data. Using this tool helps you calculate important energy spreads and understand heating/electricity generation costs.