Give compatible AI clients source-timestamped oil, gas, LNG, carbon, fuel, and related energy data through MCP. No API key is needed to try the limited demo.
oilpriceapi-mcp is an MCP project maintained in the oilpriceapi/mcp-server repository. The maintainer describes its purpose as “Give compatible AI clients source-timestamped oil, gas, LNG, carbon, fuel, and related energy data through MCP. No API key is needed to try the limited…”. Read the project documentation for the complete scope.
The documented npm package is oilpriceapi-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.
The example declares OILPRICEAPI_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| Profile | Included categories |
| all | core, market, automation |
| core | core |
| market | core, market |
| automation | core, automation |
| opa_get_product_facts | Reviewed product, offer, freshness, auth, integration, entitlement, and data-rights contract |
| opa_get_price | Current spot price for a single commodity |
| opa_market_overview | Account-visible current prices returned by the API, grouped by category |
| opa_compare_prices | Side-by-side comparison of 2-5 commodities with spread |
| opa_list_commodities | Account-visible commodity catalog returned by the live API |
| opa_get_history | Historical prices with high/low/avg/change (day/week/month/year) |
| opa_get_futures | Front-month futures (Brent, WTI, gasoil, TTF, JKM, EU carbon) |
| opa_get_futures_curve | Full forward curve with contango/backwardation analysis |
| opa_get_marine_fuels | Bunker fuel prices by port and fuel type (VLSFO/MGO/IFO380) |
| opa_get_rig_counts | Baker Hughes US total rig count with region and observation date |
| opa_get_drilling | Drilling snapshot: rig counts, frac spreads, 30-day permits, DUCs |
| opa_get_diesel_by_state | AAA retail diesel price for any US state (50 states + DC) |
| opa_get_fuel_surcharge | LTL and parcel carrier fuel surcharge percentages with effective dates and source provenance |
| opa_get_storage | Cushing and SPR oil storage/inventory levels |
| opa_get_opec_production | OPEC country-level production data |
| opa_get_forecasts | EIA STEO energy price forecasts |
| opa_get_oil_inventories | EIA weekly petroleum stocks (latest/summary/by_product) |
| opa_get_well_permits | US well drilling permits (latest/by_state/by_operator) |
| opa_search_well_permits | State-scoped permit search by county/operator/date with measured freshness gate |
| opa_lookup_well | API-number lookup with promoted lifecycle and exact monthly production when available |
| opa_get_well_activity | Recent permit counts/top operators/trends with explicit state-health warnings |
| opa_get_well_production | US well production — beta coverage (summary/states/state/well/top_producers/cycle_time/cohorts) |
| opa_get_spread | Refining/trading spreads (crack, basis, margin) |
| opa_create_price_alert | Create a persistent alert (commodity, operator, threshold, optional webhook) |
| opa_list_price_alerts | List all alerts on the account |
| opa_delete_price_alert | Permanently delete an alert by id |
| opa_get_alert_triggers | Recent alert trigger activity (optionally filtered by since) |
| opa_get_market_brief | Multi-commodity brief: prices, 24h changes, 1m forecasts, spreads, optional narrative |
| opa_create_price_subscription | Create a persistent recurring watch (codes, interval like 5m/1h/daily) |
| opa_list_subscriptions | List all subscriptions on the account |
| opa_delete_subscription | Permanently delete a subscription by id |
| opa_get_subscription_events | Poll for new watch events since a cursor (since); returns snapshots + deltas |
{
"mcpServers": {
"oilpriceapi": {
"command": "npx",
"args": [
"-y",
"oilpriceapi-mcp"
],
"env": {
"OILPRICEAPI_KEY": "YOUR_OILPRICEAPI_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| OILPRICEAPI_KEY | Declared in the maintainer’s client configuration. | Check documentation |
Provides a command-line and API-based coding assistant utilizing OpenAI APIs, function calling, and streaming.
Provides a production-ready template for building Model Context Protocol (MCP) servers with TypeScript.
Provides air quality data from the World Air Quality Index (AQICN) project.
Pay-per-call tools for agents via x402 (USDC on Base): Korean data, doc-to-Markdown, web utilities.
1trip PULSE: 21-tool AI travel planner. Flights, hotels, visa, safety, weather, 120+ cities.
Weather forecasts from 7Timer. No key required.