📦

io.github.OilpriceAPI/mcp-server

Name: io.github.OilpriceAPI/mcp-server
Rating: 1.9

Real-time oil, gas, and commodity prices. Brent, WTI, natural gas, diesel & more.

0 installs

Trust: 37 — Low

Devtools

Ask AI about io.github.OilpriceAPI/mcp-server

I know everything about io.github.OilpriceAPI/mcp-server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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.

Features

4 Tools — get prices, market overviews, price comparisons, commodity listings
4 Resources — subscribable price snapshots for Brent, WTI, Natural Gas, and all commodities
4 Prompts — pre-built analyst templates (daily briefing, spread analysis, gas market, commodity report)
Natural language — ask for "brent oil" or "natural gas", not codes
40+ commodities — oil, gas, coal, refined products, metals, forex

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"
      }
    }
  }
}

Cody (VS Code)

Add to .vscode/cody.json in your project root:

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

Global Install

npm install -g oilpriceapi-mcp

Getting an API Key

Sign up at oilpriceapi.com/signup
Get your API key from the dashboard
Add it to your MCP config as shown above

Tools

`get_commodity_price`

Get the current price of a specific commodity.

"What's the current Brent oil price?"
"Get the price of natural gas"

`get_market_overview`

Get prices for all commodities, optionally filtered by category (oil, gas, coal, refined, all).

"Give me a market overview"
"Show all oil prices"

`compare_prices`

Compare prices between 2-5 commodities.

"Compare Brent and WTI prices"
"What's the spread between US and European gas?"

`list_commodities`

List all available commodities and their codes.

Resources

Subscribable price data (JSON):

Resource	URI	Description
Brent Crude	`price://brent`	Global benchmark crude oil price
WTI Crude	`price://wti`	US benchmark crude oil price
Natural Gas	`price://natural-gas`	US Henry Hub natural gas price
All Prices	`price://all`	All tracked commodity prices

Prompts

Pre-built analyst templates:

Prompt	Description
`daily-briefing`	Energy market daily briefing with key prices and movers
`brent-wti-spread`	Analyze the Brent-WTI crude oil spread
`gas-market-analysis`	Compare US vs European natural gas markets
`commodity-report`	Detailed report on a specific commodity (parameterized)

Supported Commodities

Crude Oil

Brent Crude (global benchmark)
WTI (US benchmark)
Urals (Russian)
Dubai (Middle East)

Natural Gas

US Henry Hub ($/MMBtu)
UK NBP (pence/therm)
European TTF (EUR/MWh)

Coal

Thermal Coal
Newcastle Coal (Asia-Pacific)

Refined Products

Diesel, Gasoline, RBOB Gasoline, Jet Fuel, Heating Oil

Other

Gold, EU Carbon Allowances, UK Carbon Allowances, EUR/USD, GBP/USD

Natural Language Support

You say	We 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
"lbma gold am fix"	GOLD_AM_USD
"lbma gold pm fix"	GOLD_PM_USD
"lbma silver fix"	SILVER_FIX_USD

Development

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

License

MIT

Also Available As

Python SDK - Python client with Pandas integration
Node.js SDK - TypeScript/JavaScript SDK
Go SDK - Idiomatic Go client
OpenBB Integration - OpenBB Platform provider