v3.2.3

Futures routing

• Publish instrument-generic brent, wti, gasoil, and eu-carbon inputs.
• Preserve contract codes and older venue slugs as compatibility inputs while routing both latest and curve tools to generic API paths.
• Update packed descriptions, defaults, examples, and the protected live smoke to prefer canonical slugs.

Verification

• Protected-main run 31532265331 passed the authenticated generic Brent latest/curve smoke.
• Unit/build, audit, public claims, product facts, package, provenance, and non-root container gates passed.
• Packed runtime passed on Node 18, 20, 22, and 24.

v3.2.2

OilPriceAPI MCP 3.2.2

This is the production publication of the reviewed 3.2 product-contract release. It supersedes the publication-halted v3.2.1 tag, for which no npm package or MCP Registry entry was created.

Product contract

• Adds typed product-facts v2 discovery while preserving a checksum-bound bridge for the currently deployed v1 contract.
• Fails closed on unknown fields, incompatible identity, future-dated remote reviews, malformed metadata, and checksum drift.
• Keeps pinned, canonical, and cached facts immutable once their checksum is assigned.

Runtime and packaging

• Reports tool inventory from the actual runtime registry for read and write scopes.
• Ships deterministic build metadata, exact capability metadata, and a pinned non-root Node container.
• Removes stale fixed catalog, allowance, plan, freshness, and tool-count claims from authored and packed surfaces.

Release integrity

• Requires protected-main release provenance and immutable workflow dependencies.
• Publishes the exact verified tarball with source-bound npm provenance.
• Treats only an exact npm Registry 404 as unpublished; malformed, conflicting, or unavailable registry responses fail closed.
• Validates the complete official MCP Registry record before npm publication and verifies public npm and Registry readback afterward.

The standard production smoke is read-only. Subscription create/delete coverage remains explicit opt-in and was not enabled for this release.

v3.2.1

Publication halted: the verified release candidate did not publish to npm because the recovery preflight misclassified npm's 404 response. No oilpriceapi-mcp@3.2.1 npm artifact or MCP Registry entry was created. This immutable tag is retained for audit history and is superseded by 3.2.2.

OilPriceAPI MCP 3.2.1

Product contract

• Adds typed product-facts v2 discovery while preserving a checksum-bound bridge for the currently deployed v1 contract.
• Fails closed on unknown fields, incompatible identity, future-dated remote reviews, malformed metadata, and checksum drift.
• Keeps pinned, canonical, and cached facts immutable once their checksum is assigned.

Runtime and packaging

• Reports tool inventory from the actual runtime registry for read and write scopes.
• Ships deterministic build metadata, exact capability metadata, and a pinned non-root Node container.
• Removes stale fixed catalog, allowance, plan, freshness, and tool-count claims from authored and packed surfaces.

Release integrity

• Requires protected-main release provenance and immutable workflow dependencies.
• Publishes the exact verified tarball with source-bound npm provenance.
• Validates the complete official MCP Registry record before npm publication and verifies public npm and Registry readback afterward.

The standard production smoke remains read-only. Subscription create/delete coverage is still explicit opt-in and was not enabled for this release.

v3.2.0 — point-in-time (vintage) history

opa_get_history gains as_of (ISO8601): the series as it was knowable at that instant — rows collected later absent, values revised later rolled back. No lookahead bias for backtests. Pairs with the API's #6405 Phase 1, deployed and live-verified 2026-08-10 (DIESEL_USD serves 3.88 pre-revision with as_of, 3.90 without). Revision-correction coverage since 2026-07-28.

v3.1.0 — agent-readiness release

Four upgrades so an agent can answer "can I call this, what do I have left, what would more cost" from the schema instead of by probing (#63, #64):

• Plan-tier labels in every gated tool description — history → Developer $19+; futures/curve/marine/spreads → Professional $99+; storage/rigs/OPEC/inventories/forecasts → Reservoir Mastery; drilling → Scale; well permits → add-on/enterprise.
• New opa_get_natural_gas_hubs — six US hubs as basis to Henry Hub (Waha, SoCal Citygate, Chicago Citygate, Algonquin Citygate, Eastern Gas South, Houston Ship Channel) with per-hub history depth.
• New opa_get_account_status — plan tier, usage, remaining quota, reset date.
• New opa_get_plans — live plan ladder from the API; works keyless.
• New opa_get_data_quality — per-series quality grades and dimension scores; catalogue summary on any key.
• Gate errors (402/403/429) now point at opa_get_plans / opa_get_account_status.

36 tools. 166 tests pass; live smoke and packaged smoke green.

oilpriceapi-mcp 3.0.0

Breaking change

The default MCP inventory is now read-only: 25 tools are enabled. Account mutation tools require explicit opt-in with --scope write or OILPRICEAPI_MCP_SCOPE=write.

Added

• Stable all, core, market, and automation profiles plus category allowlists
• --version, --list-tools, doctor, doctor --demo, and --capabilities commands
• Deterministic v1 capability manifest generated from the registered MCP inventory
• Keyless oilpriceapi://product-facts resource and product-facts tool
• Quota-aware strict live release smoke and installed-package protocol smoke
• Fail-fast compatibility guard for MCP SDK registration structures
• Release smoke compatibility across npm 11 and npm 12 output formats

Upgrade check

Run npx -y oilpriceapi-mcp@3.0.0 doctor --demo without a key, then npx -y oilpriceapi-mcp@3.0.0 doctor with OILPRICEAPI_KEY set.

v2.6.1 - reviewed product facts discovery

Added

• Read-only opa_get_product_facts tool for product, pricing, freshness, catalog, auth, install, entitlement, and data-rights questions.
• Keyless oilpriceapi://product-facts MCP resource.
• Checksum-verified v1 facts contract with canonical, bounded-cache, and pinned fallback provenance.
• Packaged stdio discovery smoke coverage and release-time package verification.

Corrected

• Removed unsupported fixed catalog, latency, real-time, and entitlement claims from server instructions, manifests, and README copy.

The product-facts surface improves accuracy for connected MCP sessions; it does not update general model training or guarantee search citations.

v2.6.0 — fuel surcharge MCP tool

Adds opa_get_fuel_surcharge for LTL and parcel carrier fuel surcharge lookups, including parcel service-level support, history endpoint mapping, keyless teaser behavior, and refreshed MCP metadata.\n\nMerged PR: #48

v2.5.0 — well production tool

What's Changed

• Add the beta opa_get_well_production tool with summary, states, state, well, top_producers, cycle_time, and cohorts views.
• Fix opa_get_drilling formatting for the current /v1/drilling/latest API response shape.
• Document the HTTP 402 pricing boundary and keep plan-gated API errors surfaced with upgrade context.
• Bump package, runtime, and MCP registry metadata to 2.5.0 with 27 tools listed.

Verification

• PR #32 CI: unit/build and live API smoke passed.
• PR #40 CI: unit/build and live API smoke passed.
• Local release bump checks: version consistency, npm test (200 passed), npm run build, git diff --check.

v2.4.2 — Connectors Directory readiness

• All 26 tools: human titles + MCP tool annotations (readOnly/destructive/idempotent/openWorld hints), migrated to registerTool
• Privacy policy: manifest privacy_policies + README section
• Brand icon (512px), author → GitHub org profile
  Directory submission prep.