S&P Global Commodity Insights MCP Server for Mastra AI 12 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect S&P Global Commodity Insights through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"sp-global-commodity-insights": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "S&P Global Commodity Insights Agent",
instructions:
"You help users interact with S&P Global Commodity Insights " +
"using 12 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with S&P Global Commodity Insights?"
);
console.log(result.text);
}
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.
Mastra's agent abstraction provides a clean separation between LLM logic and S&P Global Commodity Insights tool infrastructure. Connect 12 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
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 Mastra 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 Mastra AI via MCP
Follow these steps to integrate the S&P Global Commodity Insights MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 12 tools from S&P Global Commodity Insights via MCP
Why Use Mastra AI with the S&P Global Commodity Insights MCP Server
Mastra AI provides unique advantages when paired with S&P Global Commodity Insights through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add S&P Global Commodity Insights without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every S&P Global Commodity Insights tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
S&P Global Commodity Insights + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the S&P Global Commodity Insights MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query S&P Global Commodity Insights, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed S&P Global Commodity Insights as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query S&P Global Commodity Insights on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using S&P Global Commodity Insights tools alongside other MCP servers
S&P Global Commodity Insights MCP Tools for Mastra AI (12)
These 12 tools become available when you connect S&P Global Commodity Insights to Mastra 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 Mastra AI
Ready-to-use prompts you can give your Mastra 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 Mastra AI
Common issues when connecting S&P Global Commodity Insights to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpS&P Global Commodity Insights + Mastra AI FAQ
Common questions about integrating S&P Global Commodity Insights MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
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 Mastra AI
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.