The gated tools name their own entitlement and point at the plans call, and the account-status call is explicitly the one to make after a refusal so the answer is what your plan covers rather than a status code. The data tools are equally plain about coverage: well production is marked beta and says outright that it is not complete US well-level data, the permit search fails closed on a state whose health check is failing rather than quietly returning partial results, and the activity view returns every unavailable state so a ranking cannot be mistaken for national coverage.
An energy market data client over OilPriceAPI — spot prices and history, futures and forward curves, physical gas hubs, marine fuels, US upstream activity, inventories, spreads, forecasts, and account-scoped alerts and watches. It runs from npx and works with no key at all in demo mode; the tool surface defaults to read-only, and mutations are refused unless you turn write scope on.
- opa_get_price for one commodity's latest source-timestamped value, accepting natural language such as 'brent oil' or a code such as WTI_USD, with opa_market_overview for a snapshot grouped by category and opa_compare_prices for two to five commodities side by side including the spread.
- opa_get_history over a day, week, month or year, returning high, low, average, change and data point count.
- Futures: opa_get_futures for the front-month contract and opa_get_futures_curve for the forward curve, both on canonical slugs — brent, wti, gasoil, natural-gas, ttf-gas, lng-jkm, eu-carbon and uk-carbon.
- Physical markets: opa_get_natural_gas_hubs for US hub basis to Henry Hub across Waha, SoCal Citygate, Chicago Citygate, Algonquin Citygate and Eastern Gas South, and opa_get_marine_fuels for VLSFO, MGO and IFO380 by port.
- Downstream and logistics: opa_get_diesel_by_state for AAA-sourced state averages, and opa_get_fuel_surcharge for carrier-published percentages from ODFL, Saia, Estes, XPO, ABF, TForce, Averitt, Southeastern Freight, UPS, FedEx and DHL.
- US upstream: opa_get_rig_counts from Baker Hughes, opa_get_drilling with frac spread counts, recent permits by state and DUC totals, opa_get_well_permits and opa_search_well_permits by county or operator, opa_lookup_well by API number, opa_get_well_activity and opa_get_well_production.
- Supply and inventory: opa_get_storage for Cushing and the Strategic Petroleum Reserve, opa_get_oil_inventories from EIA weekly stocks, opa_get_opec_production, and opa_get_forecasts from the EIA Short-Term Energy Outlook.
- opa_get_spread for crack spreads, basis spreads and blending and transport margins, and opa_get_market_brief, which puts spot prices, changes, forecasts for Brent, WTI and Natural Gas and notable spreads into one call.
- Account-scoped state: opa_list_price_alerts and opa_get_alert_triggers, plus opa_list_subscriptions and opa_get_subscription_events, polled with a cursor rather than pushed over a connection.
- Self-description meant to be read instead of recalled: opa_get_product_facts for the versioned product contract, opa_get_plans for live pricing and what each tier unlocks, opa_get_account_status for plan, usage, remaining quota and reset date, and opa_get_data_quality for per-series grades.
- Analyst prompt templates for briefings, spread analysis, gas markets, diesel costs and supply analysis, alongside the tools.
Nothing to start: without a key it runs in demo mode, where the price, comparison, catalog and overview tools serve a limited commodity set and every other tool explains what its account would need. A free key widens the catalog and unlocks history, futures and alerts, and the gated datasets — gas hubs, marine fuels, rig counts, drilling, storage, OPEC production, forecasts, inventories, spreads — each need an eligible plan, which opa_get_plans and opa_get_account_status will tell you about. The default scope is read-only; account mutations are refused until write scope is enabled explicitly.
One command plus a key — npx oilpriceapi-mcp, then supply credentials