OilPrice MCP Server for Vercel AI SDK 10 tools — connect in under 2 minutes
The Vercel AI SDK is the TypeScript toolkit for building AI-powered applications. Connect OilPrice through 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 OilPrice, 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 OilPrice MCP Server
Connect to OilPriceAPI and bring real-time energy commodity intelligence to any AI agent. Access 50+ energy commodities with prices updated every 5 minutes.
The Vercel AI SDK gives every OilPrice tool full TypeScript type inference, IDE autocomplete, and compile-time error checking. Connect 10 tools through 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
- WTI Crude Oil — Get current and historical West Texas Intermediate crude prices, the primary US oil benchmark
- Brent Crude — Track international crude oil prices, the global benchmark for oil trading
- Natural Gas — Monitor Henry Hub natural gas prices updated every 5 minutes
- Refined Products — Access diesel, gasoline, heating oil, and jet fuel prices
- Coal — Track Newcastle thermal coal benchmarks
- Latest Prices — Fetch current spot prices for any or all commodities
- Intraday Data — Analyze hourly price movements over the last 24 hours
- Weekly Trends — Review daily prices for the last 7 days
- Monthly Analysis — Examine daily prices for the last 30 days
- Historical Data — Query custom date ranges for long-term trend analysis (paid tier)
- Commodity Catalog — Explore all 50+ available energy commodities and their codes
The OilPrice MCP Server exposes 10 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 OilPrice to Vercel AI SDK via MCP
Follow these steps to integrate the OilPrice 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 10 tools from OilPrice and passes them to the LLM
Why Use Vercel AI SDK with the OilPrice MCP Server
Vercel AI SDK provides unique advantages when paired with OilPrice 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 OilPrice integration everywhere
Built-in streaming UI primitives let you display OilPrice 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
OilPrice + Vercel AI SDK Use Cases
Practical scenarios where Vercel AI SDK combined with the OilPrice MCP Server delivers measurable value.
AI-powered web apps: build dashboards that query OilPrice in real-time and stream results to the UI with zero loading states
API backends: create serverless endpoints that orchestrate OilPrice tools and return structured JSON responses to any frontend
Chatbots with tool use: embed OilPrice capabilities into conversational interfaces with streaming responses and tool call visibility
Internal tools: build admin panels where team members interact with OilPrice through natural language queries
OilPrice MCP Tools for Vercel AI SDK (10)
These 10 tools become available when you connect OilPrice to Vercel AI SDK via MCP:
get_brent_price
Prices update every 5 minutes. USE WHEN: - User asks specifically about Brent oil price - User needs the international crude oil benchmark - User wants to check European/global oil prices - User asks "what is Brent price" EXAMPLES: - "What is Brent price?" → call with no params - "Current Brent crude oil price" → call with no params - "Brent oil benchmark" → call with no params Get current Brent crude oil price
get_diesel_price
Important for tracking transportation fuel costs and refined product margins. USE WHEN: - User asks about diesel fuel prices - User needs refined product pricing - User wants to track diesel vs crude crack spreads - User asks "what is diesel price" EXAMPLES: - "What is diesel price?" → call with no params - "Current ULSD diesel price" → call with no params - "US diesel fuel cost" → call with no params Get current US Diesel (Ultra Low Sulfur) price
get_historical_prices
Requires a paid OilPriceAPI subscription. USE WHEN: - User asks about historical oil prices for a specific period - User wants long-term trend analysis or backtesting - User asks for prices from specific dates EXAMPLES: - "WTI prices for Q1 2026" → commodity_code="WTI_USD", start_date="2026-01-01", end_date="2026-03-31" - "Brent crude last year" → commodity_code="BRENT_CRUDE_USD", start_date="2025-01-01", end_date="2025-12-31" Get historical price data for a custom date range
get_latest_prices
Prices are updated every 5 minutes for oil, gas, and refined products. USE WHEN: - User asks about current oil prices - User needs the latest commodity prices - User wants to check current WTI or Brent prices - User asks what is the price of oil/gas/coal right now PARAMETERS: - commodity_code (OPTIONAL): Specific commodity code (e.g. "WTI_USD", "BRENT_CRUDE_USD") EXAMPLES: - "What is current oil price?" → call with commodity_code="WTI_USD" - "Latest Brent crude price" → call with commodity_code="BRENT_CRUDE_USD" - "Show all latest energy prices" → call with no params Get the latest spot prices for energy commodities
get_natural_gas_price
Prices update every 5 minutes. USE WHEN: - User asks about natural gas prices - User needs the US natural gas benchmark - User wants to check Henry Hub prices - User asks "what is natural gas price" EXAMPLES: - "What is natural gas price?" → call with no params - "Current Henry Hub gas price" → call with no params - "US natural gas benchmark" → call with no params Get current US Natural Gas (Henry Hub) price
get_past_day_prices
Perfect for tracking intraday price movements and volatility. USE WHEN: - User asks about oil price movements today - User needs hourly price data for the last day - User wants to track intraday volatility - User asks how prices changed in the last 24 hours PARAMETERS: - commodity_code (OPTIONAL): Specific commodity code EXAMPLES: - "Show WTI price movements today" → call with commodity_code="WTI_USD" - "Hourly natural gas prices last 24h" → call with commodity_code="NATURAL_GAS_USD" - "Brent crude intraday prices" → call with commodity_code="BRENT_CRUDE_USD" Get hourly prices data for the last 24 hours
get_past_month_prices
Great for monthly trend analysis and medium-term price tracking. USE WHEN: - User asks about oil price trends this month - User needs daily prices for the last 30 days - User wants to track monthly price movements - User asks how prices changed over the past month PARAMETERS: - commodity_code (OPTIONAL): Specific commodity code EXAMPLES: - "WTI price trends this month" → call with commodity_code="WTI_USD" - "Monthly natural gas prices" → call with commodity_code="NATURAL_GAS_USD" - "Brent crude last 30 days" → call with commodity_code="BRENT_CRUDE_USD" Get daily price data for the last 30 days
get_past_week_prices
Ideal for weekly trend analysis and short-term price tracking. USE WHEN: - User asks about oil price trends this week - User needs daily prices for the last week - User wants to track weekly price movements - User asks how prices changed over the past week PARAMETERS: - commodity_code (OPTIONAL): Specific commodity code EXAMPLES: - "WTI price trends this week" → call with commodity_code="WTI_USD" - "Weekly natural gas prices" → call with commodity_code="NATURAL_GAS_USD" - "Brent crude last 7 days" → call with commodity_code="BRENT_CRUDE_USD" Get daily price data for the last 7 days
get_wti_price
Prices update every 5 minutes. USE WHEN: - User asks specifically about WTI oil price - User needs the US crude oil benchmark - User wants to check American oil prices - User asks "what is WTI price" EXAMPLES: - "What is WTI price?" → call with no params - "Current WTI crude oil price" → call with no params - "West Texas Intermediate price" → call with no params Get current WTI (West Texas Intermediate) crude oil price
list_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 energy commodities are supported AVAILABLE COMMODITY TYPES: - Crude Oil: WTI_USD, BRENT_CRUDE_USD - Refined Products: DIESEL_USD, GASOLINE_USD, HEATING_OIL_USD, JET_FUEL_USD - Natural Gas: NATURAL_GAS_USD - Coal: COAL_USD - And 40+ more energy commodities EXAMPLES: - "What commodities are available?" → call with no params - "Show me all commodity codes" → call with no params - "List all energy products" → call with no params List all available energy commodities in OilPriceAPI
Example Prompts for OilPrice in Vercel AI SDK
Ready-to-use prompts you can give your Vercel AI SDK agent to start working with OilPrice immediately.
"What is the current price of WTI crude oil?"
"Show me natural gas prices for the last week."
"Compare WTI and Brent crude prices today."
Troubleshooting OilPrice MCP Server with Vercel AI SDK
Common issues when connecting OilPrice to Vercel AI SDK through the Vinkius, and how to resolve them.
createMCPClient is not a function
npm install @ai-sdk/mcpOilPrice + Vercel AI SDK FAQ
Common questions about integrating OilPrice 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 OilPrice 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 OilPrice to Vercel AI SDK
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.