{"name":"io.github.OilpriceAPI/mcp-server","slug":"oilpriceapi-mcp-server","title":null,"description":"Source-timestamped energy data and reviewed OilPriceAPI product facts for MCP clients.","url":"https://mcp.market/server/oilpriceapi-mcp-server","rating":null,"grade":"A","score":85,"certified":false,"status":"active","category":"ecommerce","tags":["ecommerce"],"presence":{"score":38,"stars":4,"forks":2,"downloads_week":1543,"last_push_at":"2026-09-14T05:26:00.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/OilpriceAPI/mcp-server","website":null,"version":"3.4.1","remotes":[],"packages":[{"registryType":"npm","identifier":"oilpriceapi-mcp","version":"3.4.1","transport":{"type":"stdio"},"environmentVariables":[{"description":"Your OilPriceAPI key from oilpriceapi.com/auth/signup. Optional: without it, keyless demo mode.","format":"string","isSecret":true,"name":"OILPRICEAPI_KEY"},{"description":"Tool scope: read (default) or write (explicit mutation opt-in).","format":"string","name":"OILPRICEAPI_MCP_SCOPE"},{"description":"Tool profile: all, core, market, or automation.","format":"string","name":"OILPRICEAPI_MCP_PROFILE"},{"description":"Comma-separated category allowlist (core, market, automation) that overrides the profile.","format":"string","name":"OILPRICEAPI_MCP_CATEGORIES"}]}],"tools":[{"name":"opa_compare_prices","description":"Compare current prices between 2-5 commodities side by side. Use when the user asks to compare commodities (e.g., 'Brent vs WTI', 'US gas vs EU gas'). Returns each commodity's price with 24h changes, plus the spread if comparing two same-currency commodities. Accepts natural language or codes.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_create_price_alert","description":"Create a PERSISTENT price alert tied to the user's OilPriceAPI account.","write_action":true,"price_micros":0,"input_schema":null},{"name":"opa_create_price_subscription","description":"Create a PERSISTENT, recurring price subscription (a 'watch') tied to the","write_action":true,"price_micros":0,"input_schema":null},{"name":"opa_delete_price_alert","description":"Permanently delete a price alert from the user's OilPriceAPI account by id.","write_action":true,"price_micros":0,"input_schema":null},{"name":"opa_delete_subscription","description":"Permanently delete a price subscription ('watch') from the user's","write_action":true,"price_micros":0,"input_schema":null},{"name":"opa_get_account_status","description":"Get the current API account's plan tier, request usage, remaining quota, and reset date. Use before calling gated tools, when the user asks about their plan/limits/usage, or after any 402/403/429 to explain what the current plan covers. Works on every plan including free.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_alert_triggers","description":"Get recent trigger activity for the user's price alerts — which alerts have","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_data_quality","description":"Get OilPriceAPI's own data-quality grades. With a commodity code: that series' quality report — overall grade/score plus dimension scores (completeness, freshness, and more) for the current period. Without a code: the API's available catalog summary (grade distribution by category). Use when the user asks how reliable/complete a series is, or which series carry the highest quality grades. The summ","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_diesel_by_state","description":"Get the current average retail diesel price for a US state. Use when the user asks about diesel prices in a specific state, diesel fuel costs by state, or state-level fuel prices. Accepts state names ('California') or 2-letter codes ('CA'). Returns the AAA-sourced state average diesel price. Covers all 50 states plus DC.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_drilling","description":"Get a drilling activity snapshot: US, Canada, and international rig counts, frac spread count, well permits issued in the last 30 days (with a by-state breakdown), and DUC (drilled-uncompleted) well totals. Use when the user asks about drilling activity, rigs vs frac spreads, or upstream operations.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_forecasts","description":"Get energy price forecasts from EIA Short-Term Energy Outlook (STEO) and other sources. Use when the user asks about price predictions, outlooks, or where oil/gas prices are heading. Returns forecast data available to the account.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_fuel_surcharge","description":"Get carrier-published fuel surcharge percentages for LTL freight and parcel carriers. Use when the user asks about current or historical fuel surcharge rates for carriers like ODFL, Saia, Estes, XPO, ABF, TForce, Averitt, Southeastern Freight, UPS, FedEx, or DHL. Auto mode treats UPS/FedEx/DHL as parcel carriers and other carrier slugs as LTL. Parcel history requires a service_level such as ground","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_futures","description":"Get the latest front-month futures contract price for energy commodities. Use canonical instrument slugs: brent, wti, gasoil, natural-gas, ttf-gas, lng-jkm, eu-carbon, or uk-carbon. Contract codes and older venue slugs remain compatibility inputs. For the forward curve returned for this account, use opa_get_futures_curve instead.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_futures_curve","description":"Get the futures forward-curve contracts returned for this account. Use canonical instrument slugs: brent, wti, gasoil, natural-gas, ttf-gas, lng-jkm, eu-carbon, or uk-carbon. Contract codes and older venue slugs remain compatibility inputs. Returns available contract months with settlement prices plus market-structure analysis.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_history","description":"Get historical price data for a commodity over a time period. Use when the user asks about price trends, historical prices, or how a commodity has performed over time. Returns high, low, average, change, and data point count. Periods: day (24h), week (7d), month (30d), year (365d). Supports point-in-time filtering via stored observation and revision timestamps. Observation-dated bulk backfills may","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_marine_fuels","description":"Get latest marine fuel (bunker) prices returned for the account, one row per port and fuel, each with the currency, unit, as-of time, age in days and stale flag the API reports. Use when the user asks about bunker fuel, marine fuel, VLSFO, MGO, IFO380, or shipping fuel costs. Filter by port name or UN/LOCODE (e.g., Singapore or SGSIN, Rotterdam or NLRTM) and/or by the fuel type the API reports: VL","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_market_brief","description":"Get a multi-commodity market brief: latest spot prices, 24h changes,","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_natural_gas_hubs","description":"Get US physical natural gas hub prices as basis to Henry Hub (USD/MMBtu). Use when the user asks about regional gas prices or hub basis — Waha (West Texas/Permian), SoCal Citygate, Chicago Citygate, Algonquin Citygate, Eastern Gas South (formerly Dominion South), Houston Ship Channel. Without a hub, returns each live hub available to the account plus its basis; with a hub, returns that hub's lates","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_oil_inventories","description":"Get the latest EIA weekly petroleum inventory (stocks) data. Use when the user asks about oil inventories, crude stocks, weekly EIA stocks, inventory builds/draws, or product-level inventory levels. Returns the latest weekly figures available to the account; optionally a summary view or a breakdown by petroleum product.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_opec_production","description":"Get the latest OPEC oil production data. Use when the user asks about OPEC output, production quotas, supply cuts, or OPEC+ compliance. Returns available country-level production figures.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_plans","description":"Get OilPriceAPI's current subscription plans: monthly/yearly price, request limits, and included features for each tier. Use when the user asks what an upgrade costs, which plan unlocks a gated tool (history, futures, natural gas hubs...), or how the tiers compare. Live pricing from the API — no key required.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_price","description":"Get the latest available, source-timestamped value for an energy commodity. Use when the user asks about a single commodity's latest price. Accepts natural language ('brent oil', 'diesel') or API codes ('WTI_USD'). Returns price, currency, available change fields, and timestamp. For multiple commodities at once, use opa_market_overview. For price trends, use opa_get_history.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_product_facts","description":"Get the reviewed, versioned OilPriceAPI product contract for product scope, evaluation offer, pricing URL, freshness policy, catalog and entitlement wording, authentication, canonical first request, keyless demo, and data-rights boundaries. Use this instead of model memory or package prose for questions about OilPriceAPI itself. No API key or paid-data entitlement is required.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_rig_counts","description":"Get the latest US rig count (Baker Hughes). Use when the user asks about drilling activity, rig counts, or oil field operations. Returns a single US total rig count with its region and observation date — this source carries no oil/gas split and no prior-week delta. For rigs broken out by US/Canada/international alongside frac spreads and permits, use opa_get_drilling. No parameters needed.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_spread","description":"Get refining and trading spreads: crack spreads (refining margin proxy), basis spreads (regional price differentials), and blending/transport margins. Use when the user asks about crack spreads, 3-2-1 crack, refining margins, basis differentials, or blend/transport margins.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_storage","description":"Get oil storage and inventory levels for Cushing, Oklahoma (WTI delivery hub) and/or the US Strategic Petroleum Reserve (SPR). Use when the user asks about oil inventories, storage levels, Cushing stocks, or the SPR. Returns current inventory levels with changes.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_subscription_events","description":"Poll for new subscription events — the recurring snapshots recorded by the","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_well_activity","description":"Get recent US well-permit activity including counts by state, top operators and formations, permit types, and weekly trend. The response also includes every non-available state-health record so stale, degraded, unavailable, or attention states are explicit; rankings must not be treated as complete national coverage when warnings exist. If the state-health index cannot be loaded, the activity summa","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_well_permits","description":"Get the latest US oil & gas well drilling permit data. Use when the user asks about well permits, new drilling permits, permitting activity, or upstream permit trends. Returns available permits; optionally filtered/aggregated by state or by operator.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_get_well_production","description":"Get US oil & gas well production data (BETA coverage: monthly state-level production from EIA + selected state regulators, and well-level histories for selected states only — NOT complete US well-level production). Views: summary (national + top states), states (reporting states returned by the API, latest month), state (monthly history for one state), well (monthly history for one well by 14-digi","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_list_commodities","description":"List the account-visible commodities returned by the live API. Use when the user asks what commodities are available for this account, what codes to use, or when another tool returns a 'commodity not recognized' error. Results are grouped by category. Dataset access varies by account entitlement. No parameters needed.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_list_price_alerts","description":"List all PERSISTENT price alerts on the user's OilPriceAPI account. Use when","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_list_subscriptions","description":"List all PERSISTENT price subscriptions ('watches') on the user's","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_lookup_well","description":"Look up a well by 10-, 12-, or 14-digit API number using the core API's promoted lifecycle summaries. Returns operator, county, lifecycle dates, cumulative production and evidence; for a 14-digit API number it also includes exact monthly well-production history when available. Optional state disambiguates API numbers that occur across source contexts. Unpromoted or ambiguous records fail closed.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_market_overview","description":"Get the current prices returned by the API for this account in one call. Use when the user wants a broad market snapshot or asks about overall energy prices. Returns available prices grouped by category (oil, gas, coal, refined products, metals, forex) with 24h changes. Supports filtering by category. Dataset access varies by account entitlement. For a single commodity, use opa_get_price instead.","write_action":false,"price_micros":0,"input_schema":null},{"name":"opa_search_well_permits","description":"Search well permits in one US state by county or operator and optional permit-date range. The tool checks the core API's measured state-health gate first, fails closed for unavailable/attention states, and always returns freshness, date coverage, source provenance, and any staleness/degradation caveat with the records. Operator and county filters currently require separate searches.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":85,"grade":"A","scanned_at":"2026-09-19T20:04:31.836Z","report":{"scannerVersion":"0.1.5","scannedAt":"2026-09-19T20:04:31.844Z","components":{"code":{"score":25,"max":25,"notes":["18 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":15,"max":15,"notes":["last push 6 days ago"]},"identity":{"score":9,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"oilpriceapi-mcp","version":"3.4.1","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-09-13T20:47:44.793Z","repositoryUrl":"git+https://github.com/OilpriceAPI/mcp-server.git","weeklyDownloads":1543}],"repo":{"found":true,"owner":"OilpriceAPI","repo":"mcp-server","archived":false,"pushedAt":"2026-09-14T05:26:00Z","stars":4,"forks":2,"openIssues":7,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/152923419?v=4","ownerCreatedAt":"2023-12-04T20:40:00Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/152923419?v=4&s=128","source":"registry","width":128,"height":128},"presence":{"stars":4,"forks":2,"downloadsWeek":1543,"license":"MIT","lastPushAt":"2026-09-14T05:26:00.000Z","score":38}}}},"grade_history":[],"reviews":[]}