S&P Global Commodity Insights MCP Server for OpenAI Agents SDK 12 tools — connect in under 2 minutes
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect S&P Global Commodity Insights through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="S&P Global Commodity Insights Assistant",
instructions=(
"You help users interact with S&P Global Commodity Insights. "
"You have access to 12 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from S&P Global Commodity Insights"
)
print(result.final_output)
asyncio.run(main())
* 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.
The OpenAI Agents SDK auto-discovers all 12 tools from S&P Global Commodity Insights through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries S&P Global Commodity Insights, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
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 OpenAI Agents SDK 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 OpenAI Agents SDK via MCP
Follow these steps to integrate the S&P Global Commodity Insights MCP Server with OpenAI Agents SDK.
Install the SDK
Run pip install openai-agents in your Python environment
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com
Run the script
Save the code above and run it: python agent.py
Explore tools
The agent will automatically discover 12 tools from S&P Global Commodity Insights
Why Use OpenAI Agents SDK with the S&P Global Commodity Insights MCP Server
OpenAI Agents SDK provides unique advantages when paired with S&P Global Commodity Insights through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
S&P Global Commodity Insights + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the S&P Global Commodity Insights MCP Server delivers measurable value.
Automated workflows: build agents that query S&P Global Commodity Insights, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries S&P Global Commodity Insights, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through S&P Global Commodity Insights tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query S&P Global Commodity Insights to resolve tickets, look up records, and update statuses without human intervention
S&P Global Commodity Insights MCP Tools for OpenAI Agents SDK (12)
These 12 tools become available when you connect S&P Global Commodity Insights to OpenAI Agents SDK 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 OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK 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 OpenAI Agents SDK
Common issues when connecting S&P Global Commodity Insights to OpenAI Agents SDK through the Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
S&P Global Commodity Insights + OpenAI Agents SDK FAQ
Common questions about integrating S&P Global Commodity Insights MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Connect S&P Global Commodity Insights with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect S&P Global Commodity Insights to OpenAI Agents SDK
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.