Commodities MCP Server for Vercel AI SDK 12 tools — connect in under 2 minutes
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect Commodities through the Vinkius and every tool is available as a typed function — ready for React Server Components, API routes, or any Node.js backend.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
async function main() {
const mcpClient = await createMCPClient({
transport: {
type: "http",
// Your Vinkius token — get it at cloud.vinkius.com
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
});
try {
const tools = await mcpClient.tools();
const { text } = await generateText({
model: openai("gpt-4o"),
tools,
prompt: "Using Commodities, list all available capabilities.",
});
console.log(text);
} finally {
await mcpClient.close();
}
}
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 Commodities MCP Server
Connect to Commodities-API and bring real-time futures market intelligence to any AI agent. Access 30+ commodities across precious metals, energy, agriculture, livestock, and industrial metals.
The Vercel AI SDK gives every Commodities tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 12 tools through the Vinkius and stream results progressively to React, Svelte, or Vue components — works on Edge Functions, Cloudflare Workers, and any Node.js runtime.
What you can do
- Precious Metals — Get current futures prices for gold, silver, platinum, and palladium (CME/NYMEX)
- Energy Commodities — Track WTI crude oil, Brent crude, and natural gas prices (NYMEX/CME)
- Agriculture — Monitor wheat, corn, soybean, coffee, cocoa, sugar, cotton, and more (CBOT/CME)
- Livestock — Access live cattle, feeder cattle, lean hogs, and Class III milk prices (CME)
- Industrial Metals — Track copper and aluminum futures (CME)
- Individual Quotes — Get instant price for any specific commodity by code
- Market Comparison — Compare prices across multiple commodities simultaneously
- Exchange Information — Know which exchange (CME, NYMEX, CBOT) trades each commodity
The Commodities MCP Server exposes 12 tools through the Vinkius. Connect it to Vercel AI 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 Commodities to Vercel AI SDK via MCP
Follow these steps to integrate the Commodities MCP Server with Vercel AI SDK.
Install dependencies
Run npm install @ai-sdk/mcp ai @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the script
Save to agent.ts and run with npx tsx agent.ts
Explore tools
The SDK discovers 12 tools from Commodities and passes them to the LLM
Why Use Vercel AI SDK with the Commodities MCP Server
Vercel AI SDK provides unique advantages when paired with Commodities through the Model Context Protocol.
TypeScript-first: every MCP tool gets full type inference, IDE autocomplete, and compile-time error checking out of the box
Framework-agnostic core works with Next.js, Nuxt, SvelteKit, or any Node.js runtime — same Commodities integration everywhere
Built-in streaming UI primitives let you display Commodities tool results progressively in React, Svelte, or Vue components
Edge-compatible: the AI SDK runs on Vercel Edge Functions, Cloudflare Workers, and other edge runtimes for minimal latency
Commodities + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the Commodities MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query Commodities in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate Commodities tools and return structured JSON responses to any frontend
Chatbots with tool use: embed Commodities capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with Commodities through natural language queries
Commodities MCP Tools for Vercel AI SDK (12)
These 12 tools become available when you connect Commodities to Vercel AI SDK via MCP:
get_agriculture_commodities_prices
Perfect for tracking agricultural markets. USE WHEN: - User asks about agriculture commodity prices - User wants to see all agricultural commodities at once - User needs to track food commodity pricing - User asks "show me agriculture commodity prices" EXAMPLES: - "What are agriculture commodity prices?" → call with no params - "Show me wheat, corn, coffee, cocoa prices" → call with no params - "Agriculture market today" → call with no params Get current prices for major agriculture commodities
get_brent_crude_oil_price
Brent is the international oil benchmark used for global pricing. USE WHEN: - User asks about Brent oil prices - User needs the international oil benchmark - User wants to compare WTI vs Brent spread - User asks "what is Brent price" EXAMPLES: - "What is Brent oil price?" → call with no params - "Current Brent crude price" → call with no params - "Brent oil benchmark today" → call with no params Get current Brent crude oil futures price
get_coffee_price
Coffee is one of the most traded agricultural commodities globally. USE WHEN: - User asks about coffee prices - User needs the soft commodity benchmark - User wants to track agricultural pricing - User asks "what is coffee price" EXAMPLES: - "What is coffee price?" → call with no params - "Current coffee futures price" → call with no params - "Coffee spot price today" → call with no params Get current coffee futures price
get_copper_price
Copper is known as "Dr. Copper" for its ability to predict economic health. USE WHEN: - User asks about copper prices - User needs the industrial metals benchmark - User wants to track economic indicators - User asks "what is copper price" EXAMPLES: - "What is copper price?" → call with no params - "Current copper futures price" → call with no params - "Copper spot price today" → call with no params Get current copper futures price
get_crude_oil_price
WTI is the primary US oil benchmark. USE WHEN: - User asks about crude oil prices - User needs the US oil benchmark - User wants to check WTI pricing - User asks "what is oil price" EXAMPLES: - "What is crude oil price?" → call with no params - "Current WTI oil price" → call with no params - "Crude oil futures today" → call with no params Get current WTI crude oil futures price
get_energy_commodities_prices
Essential for tracking the energy market. USE WHEN: - User asks about energy commodity prices - User wants to see all energy commodities at once - User needs to compare oil vs gas prices - User asks "show me energy commodity prices" EXAMPLES: - "What are energy commodity prices?" → call with no params - "Show me oil and gas prices" → call with no params - "Energy market today" → call with no params Get current prices for crude oil, Brent crude, and natural gas
get_gold_price
Gold is the primary precious metal benchmark traded globally. USE WHEN: - User asks specifically about gold price - User needs the gold benchmark price - User wants to check precious metals pricing - User asks "what is gold price" EXAMPLES: - "What is gold price?" → call with no params - "Current gold futures price" → call with no params - "Gold spot price today" → call with no params Get current gold futures price
get_natural_gas_price
Natural gas is a key energy commodity for heating and electricity generation. USE WHEN: - User asks about natural gas prices - User needs the natural gas benchmark - User wants to check energy pricing - User asks "what is natural gas price" EXAMPLES: - "What is natural gas price?" → call with no params - "Current natural gas futures" → call with no params - "Natural gas spot price today" → call with no params Get current natural gas futures price
get_precious_metals_prices
Perfect for tracking the precious metals market comprehensively. USE WHEN: - User asks about precious metals prices - User wants to see all precious metals at once - User needs to compare gold, silver, platinum, palladium - User asks "show me precious metals prices" EXAMPLES: - "What are precious metals prices?" → call with no params - "Show me gold, silver, platinum, palladium" → call with no params - "Precious metals market today" → call with no params Get current prices for gold, silver, platinum, and palladium
get_silver_price
Silver is the second most traded precious metal after gold. USE WHEN: - User asks specifically about silver price - User needs the silver benchmark price - User wants to compare gold vs silver ratio - User asks "what is silver price" EXAMPLES: - "What is silver price?" → call with no params - "Current silver futures price" → call with no params - "Silver spot price today" → call with no params Get current silver futures price
get_wheat_price
Wheat is a key agricultural commodity for global food security. USE WHEN: - User asks about wheat prices - User needs the grain benchmark - User wants to track agricultural commodities - User asks "what is wheat price" EXAMPLES: - "What is wheat price?" → call with no params - "Current wheat futures price" → call with no params - "Wheat spot price today" → call with no params Get current wheat futures price
list_all_commodities
USE WHEN: - User wants to explore what commodities are available - User needs to find commodity codes for querying prices - User is exploring the API capabilities for the first time - User asks what commodities are supported CATEGORIES: - Precious Metals: gold, silver, platinum, palladium (CME/NYMEX) - Energy: crude_oil, brent_crude_oil, natural_gas (NYMEX/CME) - Agriculture: wheat, corn, soybean, coffee, cocoa, sugar (CBOT/CME) - Livestock: live_cattle, feeder_cattle, lean_hogs (CME) - Industrial Metals: copper, aluminum (CME) EXAMPLES: - "What commodities are available?" → call with no params - "Show me all commodity codes" → call with no params - "List all commodity exchanges" → call with no params List all 30+ available commodities with their codes and exchanges
Example Prompts for Commodities in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with Commodities immediately.
"What is the current price of gold?"
"Show me energy commodity prices — oil and natural gas."
"What are the current agriculture commodity prices for wheat, coffee, and cocoa?"
Troubleshooting Commodities MCP Server with Vercel AI SDK
Common issues when connecting Commodities to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpCommodities + Vercel AI SDK FAQ
Common questions about integrating Commodities MCP Server with Vercel AI SDK.
How does the Vercel AI SDK connect to MCP servers?
createMCPClient from @ai-sdk/mcp and pass the server URL. The SDK discovers all tools and provides typed TypeScript interfaces for each one.Can I use MCP tools in Edge Functions?
Does it support streaming tool results?
useChat and streamText that handle tool calls and display results progressively in the UI.Connect Commodities 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 Commodities to Vercel AI SDK
Get your token, paste the configuration, and start using 12 tools in under 2 minutes. No API key management needed.