What commodity types and benchmarks are covered?

The API covers over 12,000 daily price assessments across: Crude Oil (WTI, Brent, Dubai, Mars, WCS + hundreds of grades), Natural Gas (Henry Hub, TTF, NBP, JKM), Electric Power (PJM, ERCOT, CAISO, European markets), Coal (Newcastle, API2, API4), Refined Products (gasoline, diesel, jet fuel), Petrochemicals (ethylene, propylene, benzene), Metals (copper, aluminum, gold, steel), Agriculture (wheat, corn, soybeans, fertilizers), and Energy Transition (carbon credits, battery metals, RECs).

How do I get an S&P Global Commodity Insights API key?

API access requires an active S&P Global Commodity Insights subscription. Contact your S&P Global account manager or visit https://www.spglobal.com/commodityinsights to discuss licensing options. Once licensed, you'll receive API credentials through your SSO (Single Sign-On) account. The authentication uses Bearer tokens generated via the /auth/api endpoint with your SSO email and password.

Are the prices real-time or delayed?

S&P Global Platts price assessments are published daily based on market activity. Most assessments reflect same-day or next-day values depending on the commodity and market. Some benchmarks (especially power markets) may have intra-day updates. Historical data is available for backtesting and trend analysis with flexible date range queries. The exact publication timing varies by commodity — crude oil and gas benchmarks are typically available by end of trading day.

Can I query historical prices for trend analysis?

Yes! Use the `get_historical_commodity_prices` tool with a specific commodity identifier, start date, and optional end date. You can query daily, weekly, or monthly aggregated data. For example, to get WTI crude prices for the last 30 days, use commodity='crude-oil', start_date='2026-03-08'. The API provides extensive historical data suitable for backtesting, trend analysis, and market research.

S&P Global Commodity Insights MCP Server for Google ADK 12 tools — connect in under 2 minutes

Name: S&P Global Commodity Insights
Availability: InStock
Author: Vinkius

google.github.io/adk-docs/tools/mcp-tools

Built by Vinkius GDPR 12 Tools SDK

Google Agent Development Kit (ADK) is Google's framework for building production AI agents. Add S&P Global Commodity Insights as an MCP tool provider through Vinkius and your ADK agents can call every tool with full schema introspection.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import (
    StreamableHTTPConnectionParams,
)

# Your Vinkius token. get it at cloud.vinkius.com
mcp_tools = McpToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    )
)

agent = Agent(
    model="gemini-2.5-pro",
    name="sp_global_commodity_insights_agent",
    instruction=(
        "You help users interact with S&P Global Commodity Insights "
        "using 12 available tools."
    ),
    tools=[mcp_tools],
)

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About S&P Global Commodity Insights MCP Server

Connect to S&P Global Commodity Insights API and bring world-class commodity intelligence to any AI agent. Access over 12,000 daily price assessments from Platts, the industry-standard benchmark for global commodity trading.

Google ADK natively supports S&P Global Commodity Insights as an MCP tool provider. declare Vinkius Edge URL and the framework handles discovery, validation, and execution automatically. Combine 12 tools with Gemini's long-context reasoning for complex multi-tool workflows, with production-ready session management and evaluation built in.

What you can do

Crude Oil Prices — Retrieve daily price assessments for WTI, Brent, Dubai, Mars, WCS and hundreds of crude grades worldwide
Natural Gas — Access Henry Hub, TTF, NBP, JKM and other major gas hub benchmarks with spot and forward prices
Electric Power — Query wholesale electricity prices for PJM, ERCOT, CAISO, European and Asia-Pacific power markets
Coal — Monitor Newcastle, API2, API4 and regional thermal/metallurgical coal benchmarks
Refined Products — Track gasoline (RBOB, Eurobob), diesel (ULSD, Gasoil), jet fuel and fuel oil prices globally
Petrochemicals — Get ethylene, propylene, benzene, toluene and other chemical feedstock prices
Metals — Access base metals (copper, aluminum, zinc), precious metals (gold, silver) and steel/iron ore benchmarks
Agriculture — Query wheat, corn, soybeans, fertilizers (urea, DAP, potash) and other agricultural commodities
Energy Transition — Monitor carbon credits (EUA, RINs), battery metals (lithium, cobalt), RECs and green hydrogen assessments
Historical Analysis — Fetch historical price data with flexible date ranges for trend analysis and backtesting
Methodology Access — Retrieve specification documents and calculation methods for any price assessment
Category Exploration — Browse the complete commodity catalog to discover available benchmarks

The S&P Global Commodity Insights MCP Server exposes 12 tools through the Vinkius. Connect it to Google ADK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect S&P Global Commodity Insights to Google ADK via MCP

Follow these steps to integrate the S&P Global Commodity Insights MCP Server with Google ADK.

Install Google ADK

Run pip install google-adk

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Create the agent

Save the code above and integrate into your ADK workflow

Explore tools

The agent will discover 12 tools from S&P Global Commodity Insights via MCP

Why Use Google ADK with the S&P Global Commodity Insights MCP Server

Google ADK provides unique advantages when paired with S&P Global Commodity Insights through the Model Context Protocol.

Google ADK natively supports MCP tool servers. declare a tool provider and the framework handles discovery, validation, and execution

Built on Gemini models, ADK provides long-context reasoning ideal for complex multi-tool workflows with S&P Global Commodity Insights

Production-ready features like session management, evaluation, and deployment come built-in. not bolted on

Seamless integration with Google Cloud services means you can combine S&P Global Commodity Insights tools with BigQuery, Vertex AI, and Cloud Functions

S&P Global Commodity Insights + Google ADK Use Cases

Practical scenarios where Google ADK combined with the S&P Global Commodity Insights MCP Server delivers measurable value.

Enterprise data agents: ADK agents query S&P Global Commodity Insights and cross-reference results with internal databases for comprehensive analysis

Multi-modal workflows: combine S&P Global Commodity Insights tool responses with Gemini's vision and language capabilities in a single agent

Automated compliance checks: schedule ADK agents to query S&P Global Commodity Insights regularly and flag policy violations or configuration drift

Internal tool platforms: build self-service agent platforms where teams connect their own MCP servers including S&P Global Commodity Insights

S&P Global Commodity Insights MCP Tools for Google ADK (12)

These 12 tools become available when you connect S&P Global Commodity Insights to Google ADK via MCP:

get_agriculture_prices

USE WHEN: - User asks about agriculture commodity prices - User needs wheat, corn, soybean, or other crop prices - User wants agricultural market benchmarks - User asks about food commodity pricing AVAILABLE COMMODITIES: - Wheat, Corn, Soybeans, Soybean Meal/Oil - Rice, Barley, Oats - Fertilizers (Urea, DAP, Potash) PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - commodity (OPTIONAL): Specific commodity (e.g. "Wheat", "Corn") - region (OPTIONAL): Region of origin/destination EXAMPLES: - "Wheat prices today" → call with commodity="Wheat" - "Corn prices this week" → call with commodity="Corn" - "Urea fertilizer prices" → call with commodity="Urea" Get agriculture commodity price assessments from S&P Global Platts

get_assessment_methodology

USE WHEN: - User asks about how a specific price is calculated - User needs the methodology behind a benchmark - User wants specification details for an assessment - User asks about market conventions for a commodity PARAMETERS: - assessment_code (REQUIRED): Assessment code or symbol (e.g. "WTI_Cushing", "Henry_Hub") EXAMPLES: - "How is WTI Cushing price calculated?" → call with assessment_code="WTI_Cushing" - "Henry Hub methodology" → call with assessment_code="Henry_Hub" - "Brent assessment specifications" → call with assessment_code="Brent" Get methodology and metadata for a specific price assessment

get_coal_prices

USE WHEN: - User asks about coal prices - User needs Newcastle, API2, or other coal benchmark prices - User wants thermal or metallurgical coal market data - User asks about coal market trends AVAILABLE BENCHMARKS: - Newcastle (Australia), API2 (Rotterdam) - API4 (Richards Bay), Columbian FOB - Various regional thermal and coking coal prices PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - type (OPTIONAL): Coal type ("thermal" or "metallurgical") - benchmark (OPTIONAL): Specific benchmark (e.g. "Newcastle", "API2") EXAMPLES: - "Newcastle coal price today" → call with benchmark="Newcastle" - "Thermal coal prices this week" → call with type="thermal" - "API2 Rotterdam coal prices" → call with benchmark="API2" Get coal price assessments from S&P Global Platts

get_crude_oil_prices

Includes spot and forward prices for major crude grades. USE WHEN: - User asks about crude oil prices or benchmarks - User needs WTI, Brent, Dubai, or other crude grade prices - User wants historical or current oil price assessments - User asks about oil market pricing AVAILABLE CRUDE GRADES: - WTI (West Texas Intermediate), Brent, Dubai/Oman - Mars, LLS, WCS, Forties, and many regional grades PARAMETERS: - date (OPTIONAL): Specific date for assessment (YYYY-MM-DD format, defaults to latest) - region (OPTIONAL): Filter by region (e.g. "US", "Middle East", "North Sea") - grade (OPTIONAL): Specific crude grade (e.g. "WTI", "Brent") EXAMPLES: - "What is current WTI crude oil price?" → call with grade="WTI" - "Brent oil prices this week" → call with grade="Brent", date="2026-04-07" - "Middle East crude assessments" → call with region="Middle East" Get crude oil price assessments from S&P Global Platts

get_energy_transition_data

USE WHEN: - User asks about renewable energy prices or markets - User needs carbon credit or EUA (EU Allowance) prices - User wants battery metal assessments (lithium, cobalt) - User asks about energy transition or sustainability metrics AVAILABLE DATA: - Carbon credits (EUA, RINs, LCFS) - Battery metals (Lithium, Cobalt, Graphite) - Renewable energy certificates (RECs) - Green hydrogen assessments PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - category (OPTIONAL): Category (e.g. "carbon", "battery_metals", "renewables") EXAMPLES: - "Carbon credit prices today" → call with category="carbon" - "Lithium prices for batteries" → call with category="battery_metals" - "EU Allowance (EUA) prices" → call with category="carbon" Get energy transition market data and assessments

get_historical_commodity_prices

Essential for trend analysis, backtesting, and market research. USE WHEN: - User asks about historical price trends - User needs price data over a specific time period - User wants to compare prices across dates - User asks for weekly, monthly, or yearly price history PARAMETERS: - commodity (REQUIRED): Commodity identifier (e.g. "crude-oil", "natural-gas", "coal") - start_date (REQUIRED): Start date (YYYY-MM-DD) - end_date (OPTIONAL): End date (YYYY-MM-DD, defaults to today) - frequency (OPTIONAL): Data frequency ("daily", "weekly", "monthly") EXAMPLES: - "WTI oil prices for last 30 days" → call with commodity="crude-oil", start_date="2026-03-08" - "Natural gas prices this month" → call with commodity="natural-gas", start_date="2026-04-01" - "Coal price history last quarter" → call with commodity="coal", start_date="2026-01-01", end_date="2026-03-31" Get historical price data for a specific commodity with date range

get_metals_prices

USE WHEN: - User asks about metal prices - User needs copper, aluminum, zinc, or other base metal prices - User wants steel or iron ore benchmarks - User asks about precious metals (gold, silver) AVAILABLE METALS: - Base: Copper, Aluminum, Zinc, Nickel, Lead - Precious: Gold, Silver, Platinum - Steel, Iron Ore, Tin PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - metal (OPTIONAL): Specific metal (e.g. "Copper", "Aluminum") - exchange (OPTIONAL): Exchange reference (e.g. "LME", "COMEX") EXAMPLES: - "Copper price today" → call with metal="Copper" - "LME aluminum prices" → call with metal="Aluminum", exchange="LME" - "Gold price assessment" → call with metal="Gold" Get metals price assessments from S&P Global Platts

get_natural_gas_prices

USE WHEN: - User asks about natural gas prices - User needs Henry Hub, NBP, TTF, or other gas hub prices - User wants gas market pricing by region or hub - User asks about LNG prices AVAILABLE HUBS/INDICES: - Henry Hub (US), NBP (UK), TTF (Netherlands) - JKM (Japan/Korea Marker), Alberta (Canada) - And many regional hubs globally PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - region (OPTIONAL): Region filter (e.g. "US", "Europe", "Asia") - hub (OPTIONAL): Specific hub (e.g. "Henry Hub", "TTF") EXAMPLES: - "Current Henry Hub natural gas price" → call with hub="Henry Hub" - "European gas prices today" → call with region="Europe", date="2026-04-07" - "JKM LNG prices this week" → call with hub="JKM" Get natural gas price assessments from S&P Global Platts

get_petrochemicals_prices

USE WHEN: - User asks about petrochemical or chemical prices - User needs ethylene, propylene, benzene, or other chemical prices - User wants petrochemical feedstock pricing - User asks about chemical market benchmarks AVAILABLE CHEMICALS: - Ethylene, Propylene, Benzene, Toluene - Xylene, Butadiene, Methanol - Various polymer and derivative prices PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - region (OPTIONAL): Region (e.g. "US", "Europe", "Asia") - chemical (OPTIONAL): Specific chemical name EXAMPLES: - "Ethylene prices today" → call with chemical="Ethylene" - "Asian petrochemical prices this week" → call with region="Asia" - "Benzene price assessments" → call with chemical="Benzene" Get petrochemicals price assessments from S&P Global Platts

get_power_prices

USE WHEN: - User asks about electricity or power prices - User needs wholesale power market prices - User wants regional electricity benchmarks - User asks about power trading hubs AVAILABLE MARKETS: - US regions (PJM, ERCOT, CAISO, NYISO, etc.) - European power markets (EPEX, Nord Pool) - Asia-Pacific power benchmarks PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - region (OPTIONAL): Region or market (e.g. "PJM", "ERCOT", "CAISO") - hub (OPTIONAL): Specific trading hub EXAMPLES: - "PJM electricity prices today" → call with region="PJM", date="2026-04-07" - "ERCOT power prices for Texas" → call with region="ERCOT" - "European power prices this week" → call with region="Europe" Get electric power price assessments from S&P Global Platts

get_refined_products_prices

USE WHEN: - User asks about gasoline, diesel, or jet fuel prices - User needs refined product benchmarks (ULSD, RBOB) - User wants fuel oil or lubricant prices - User asks about refined product markets AVAILABLE PRODUCTS: - Gasoline (RBOB, Eurobob), Diesel (ULSD, Gasoil) - Jet Fuel, Fuel Oil, Naphtha - Lubricants, Bitumen, LPG PARAMETERS: - date (OPTIONAL): Specific date (YYYY-MM-DD) - product (OPTIONAL): Specific product (e.g. "Diesel", "Gasoline") - region (OPTIONAL): Region (e.g. "US", "Europe", "Singapore") EXAMPLES: - "Diesel prices today" → call with product="Diesel" - "RBOB gasoline prices" → call with product="Gasoline" - "Singapore jet fuel prices" → call with product="Jet Fuel", region="Singapore" Get refined petroleum products price assessments

list_commodity_categories

USE WHEN: - User wants to explore what commodity categories are available - User needs to understand the scope of price assessments - User is exploring the API capabilities for the first time - User asks what types of commodities are covered CATEGORIES INCLUDE: - Crude Oil, Natural Gas, Electric Power, Coal - Petrochemicals, Metals, Agriculture - Energy Transition, Refined Products EXAMPLES: - "What commodity categories are available?" → call with no params - "Show me all commodity types" → call with no params - "List all price assessment categories" → call with no params List all available commodity categories in S&P Global Commodity Insights

Example Prompts for S&P Global Commodity Insights in Google ADK

Ready-to-use prompts you can give your Google ADK agent to start working with S&P Global Commodity Insights immediately.

"What is the current WTI crude oil price?"

"Show me natural gas prices at Henry Hub and TTF for today."

"What are current carbon credit prices (EUA)?"

Troubleshooting S&P Global Commodity Insights MCP Server with Google ADK

Common issues when connecting S&P Global Commodity Insights to Google ADK through the Vinkius, and how to resolve them.

McpToolset not found

Update: pip install --upgrade google-adk

S&P Global Commodity Insights + Google ADK FAQ

Common questions about integrating S&P Global Commodity Insights MCP Server with Google ADK.

How does Google ADK connect to MCP servers?

Import the MCP toolset class and pass the server URL. ADK discovers and registers all tools automatically, making them available to your agent's tool-use loop.

Can ADK agents use multiple MCP servers?

Yes. Declare multiple MCP tool providers in your agent configuration. ADK merges all tool schemas and the agent can call tools from any server in a single turn.

Which Gemini models work best with MCP tools?

Gemini 2.0 Flash and Pro models both support function calling required for MCP tools. Flash is recommended for latency-sensitive use cases, Pro for complex reasoning.