Oilpriceapi MCP Server

by oilpriceapiio.github.OilpriceAPI/mcp-serverv3.4.2

Real-time oil, gas and commodity prices: spot, history, futures curves, price alerts and market briefs for Brent, WTI, diesel, jet fuel and more.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active6d ago

Install Oilpriceapi MCP server

claude mcp add oilpriceapi -e OILPRICEAPI_KEY='<oilpriceapi-key>' -- npx -y oilpriceapi-mcp

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": [
        "-y",
        "oilpriceapi-mcp"
      ],
      "env": {
        "OILPRICEAPI_KEY": "<oilpriceapi-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": [
        "-y",
        "oilpriceapi-mcp"
      ],
      "env": {
        "OILPRICEAPI_KEY": "<oilpriceapi-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

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

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": [
        "-y",
        "oilpriceapi-mcp"
      ],
      "env": {
        "OILPRICEAPI_KEY": "<oilpriceapi-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
OILPRICEAPI_KEY	—	yes	Your OilPriceAPI key from oilpriceapi.com/auth/signup. Optional: without it, keyless demo mode.
OILPRICEAPI_MCP_SCOPE	—	—	Tool scope: read (default) or write (explicit mutation opt-in).
OILPRICEAPI_MCP_PROFILE	—	—	Tool profile: all, core, market, or automation.
OILPRICEAPI_MCP_CATEGORIES	—	—	Comma-separated category allowlist (core, market, automation) that overrides the profile.

Freshness

Active — last maintenance signal 6d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-04 · 6d ago · GitHub
Latest release
2026-10-03 · 6d ago · GitHub · v3.4.2
Package published
no data · npm/PyPI
Registry entry updated
2026-10-03 · 6d ago · official registry · v3.4.2

FAQ

›How do I install the Oilpriceapi MCP server in Claude Code?

Run: claude mcp add oilpriceapi -e OILPRICEAPI_KEY='<oilpriceapi-key>' -- npx -y oilpriceapi-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Oilpriceapi require an API key?

Yes. It expects OILPRICEAPI_KEY, of which 1 is a secret.

›Can I use Oilpriceapi as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Oilpriceapi in the official MCP registry?

Yes, as io.github.OilpriceAPI/mcp-server.