OilPriceAPI

Real-time oil, gas, and commodity prices. 40+ energy commodities with natural language queries, price subscriptions, and analyst prompts.

GitHub

OilPriceAPI MCP Server

The energy commodity MCP server. Real-time oil, gas, and commodity prices for Claude, Cursor, VS Code, and any MCP-compatible client.

npm license

Features

  • 14 Tools — spot prices, history, futures, marine fuels, rig counts, diesel by state, storage, OPEC production, forecasts
  • 5 Resources — subscribable price snapshots for Brent, WTI, Natural Gas, Diesel, and all commodities
  • 6 Prompts — pre-built analyst templates (daily briefing, spread analysis, gas markets, commodity report, diesel costs, supply analysis)
  • Natural language — ask for "brent oil" or "natural gas", not codes
  • 70+ commodities — oil, gas, coal, refined products, metals, forex, bunker fuels, state diesel
  • Smart errors — unrecognized commodities get suggestions, not silent fallbacks

Quick Start

npx oilpriceapi-mcp

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code + Cline

Add to .vscode/mcp.json:

{
  "servers": {
    "oilpriceapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Global Install

npm install -g oilpriceapi-mcp

Environment Variables

VariableRequiredDescription
OILPRICEAPI_KEYYesAPI key from oilpriceapi.com/signup. Free tier: 200 requests/month.
OILPRICEAPI_BASE_URLNoOverride API base URL (for staging/testing). Default: https://api.oilpriceapi.com

Tools

All tools are prefixed with opa_ to avoid name collisions when multiple MCP servers are loaded.

ToolDescription
opa_get_priceCurrent spot price for a single commodity
opa_market_overviewAll commodity prices in one call, grouped by category
opa_compare_pricesSide-by-side comparison of 2-5 commodities with spread
opa_list_commoditiesFull commodity catalog (fetched live from API)
opa_get_historyHistorical prices with high/low/avg/change (day/week/month/year)
opa_get_futuresFront-month futures price (Brent BZ or WTI CL)
opa_get_futures_curveFull forward curve with contango/backwardation analysis
opa_get_marine_fuelsBunker fuel prices by port and fuel type (VLSFO/MGO/IFO380)
opa_get_rig_countsBaker Hughes US rig count with week-over-week change
opa_get_drillingDrilling intelligence: wells, permits, completions by region
opa_get_diesel_by_stateAAA retail diesel price for any US state (50 states + DC)
opa_get_storageCushing and SPR oil storage/inventory levels
opa_get_opec_productionOPEC country-level production data
opa_get_forecastsEIA STEO energy price forecasts

Example Questions

"What's the current Brent oil price?"
"Compare Brent and WTI crude"
"Show me oil prices for the past month"
"What's diesel cost in California vs Texas?"
"Give me a market overview of refined products"
"What's the Brent futures curve look like?"
"How many oil rigs are active in the US?"
"What are OPEC production levels?"
"What are bunker fuel prices in Singapore?"
"Show me Cushing storage levels"

Resources

Subscribable price data (JSON):

ResourceURIDescription
Brent Crudeprice://brentGlobal benchmark crude oil price
WTI Crudeprice://wtiUS benchmark crude oil price
Natural Gasprice://natural-gasUS Henry Hub natural gas price
Dieselprice://dieselUS national average diesel price
All Pricesprice://allAll tracked commodity prices

Prompts

Pre-built analyst templates:

PromptDescription
daily-briefingEnergy market daily briefing with key prices and movers
brent-wti-spreadAnalyze the Brent-WTI crude oil spread
gas-market-analysisCompare US vs European natural gas markets
commodity-reportDetailed report on a specific commodity (parameterized)
diesel-cost-analysisCompare diesel prices across US states for fleet planning
supply-analysisAnalyze supply using OPEC production, rig counts, storage

Natural Language Support

You sayWe understand
"brent oil", "brent crude"BRENT_CRUDE_USD
"wti", "us oil"WTI_USD
"natural gas", "henry hub"NATURAL_GAS_USD
"european gas", "ttf"DUTCH_TTF_EUR
"diesel"DIESEL_USD
"gold"GOLD_USD
"jet fuel", "aviation fuel"JET_FUEL_USD
"carbon", "carbon credits"EU_CARBON_EUR

Development

npm install
npm run build
npm test
OILPRICEAPI_KEY=your-key node build/index.js

Breaking Changes in v2.0.0

  • All tool names now use opa_ prefix (e.g., get_commodity_price -> opa_get_price)
  • Unrecognized commodity names now return an error with suggestions instead of silently defaulting to Brent
  • list_commodities now fetches live from the API (falls back to static list if unavailable)

License

MIT

Links

Also Available As

Related Servers

NotebookLM Web Importer

Import web pages and YouTube videos to NotebookLM with one click. Trusted by 200,000+ users.

Install Chrome Extension