S&P Global Commodity Insights MCP Server for Pydantic AI 12 tools — connect in under 2 minutes
Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect S&P Global Commodity Insights through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
agent = Agent(
model="openai:gpt-4o",
mcp_servers=[server],
system_prompt=(
"You are an assistant with access to S&P Global Commodity Insights "
"(12 tools)."
),
)
result = await agent.run(
"What tools are available in S&P Global Commodity Insights?"
)
print(result.data)
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.
Pydantic AI validates every S&P Global Commodity Insights tool response against typed schemas, catching data inconsistencies at build time. Connect 12 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
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 Pydantic AI 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 Pydantic AI via MCP
Follow these steps to integrate the S&P Global Commodity Insights MCP Server with Pydantic AI.
Install Pydantic AI
Run pip install pydantic-ai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.py and run: python agent.py
Explore tools
The agent discovers 12 tools from S&P Global Commodity Insights with type-safe schemas
Why Use Pydantic AI with the S&P Global Commodity Insights MCP Server
Pydantic AI provides unique advantages when paired with S&P Global Commodity Insights through the Model Context Protocol.
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your S&P Global Commodity Insights integration code
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
Dependency injection system cleanly separates your S&P Global Commodity Insights connection logic from agent behavior for testable, maintainable code
S&P Global Commodity Insights + Pydantic AI Use Cases
Practical scenarios where Pydantic AI combined with the S&P Global Commodity Insights MCP Server delivers measurable value.
Type-safe data pipelines: query S&P Global Commodity Insights with guaranteed response schemas, feeding validated data into downstream processing
API orchestration: chain multiple S&P Global Commodity Insights tool calls with Pydantic validation at each step to ensure data integrity end-to-end
Production monitoring: build validated alert agents that query S&P Global Commodity Insights and output structured, schema-compliant notifications
Testing and QA: use Pydantic AI's dependency injection to mock S&P Global Commodity Insights responses and write comprehensive agent tests
S&P Global Commodity Insights MCP Tools for Pydantic AI (12)
These 12 tools become available when you connect S&P Global Commodity Insights to Pydantic AI 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 Pydantic AI
Ready-to-use prompts you can give your Pydantic AI 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 Pydantic AI
Common issues when connecting S&P Global Commodity Insights to Pydantic AI through the Vinkius, and how to resolve them.
MCPServerHTTP not found
pip install --upgrade pydantic-aiS&P Global Commodity Insights + Pydantic AI FAQ
Common questions about integrating S&P Global Commodity Insights MCP Server with Pydantic AI.
How does Pydantic AI discover MCP tools?
MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.Does Pydantic AI validate MCP tool responses?
Can I switch LLM providers without changing MCP code?
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 Pydantic AI
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.