MCP Server

🚀 OilPriceAPI MCP Server

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

✨ Features

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

🚀 Quick Start

npx oilpriceapi-mcp

📦 Installation

Claude Desktop

Add the following 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

1. Sign up at oilpriceapi.com/signup.
2. Obtain your API key from the dashboard.
3. Add it to your MCP config as demonstrated above.

💻 Tools

get_commodity_price

Retrieve 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):

📚 Prompts

Pre-built analyst templates:

📚 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

🔧 Development

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

📄 License

MIT

📚 Links

• OilPriceAPI
• API Documentation
• Pricing
• MCP Protocol

📚 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