Alpaca Trading API integration for Model Context Protocol (MCP)
Oilpriceapi is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Source-timestamped energy data and reviewed OilPriceAPI product facts for MCP clients.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user oilpriceapi-mcp '--' npx -y oilpriceapi-mcp
# 2 — ask your agent for something these tools do
# opa_get_product_facts, opa_get_price, opa_market_overview and 33 more
Oilpriceapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Oilpriceapi as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user oilpriceapi-mcp '--' npx -y oilpriceapi-mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Nothing is required, but it can take OILPRICEAPI_KEY (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.) if you want to set them.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
36 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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…
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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.
No parameter schema on file.
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 parameter schema on file.
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…
No parameter schema on file.
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,…
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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.
No parameter schema on file.
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.…
No parameter schema on file.
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…
No parameter schema on file.
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.
No parameter schema on file.
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.
No parameter schema on file.
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.
No parameter schema on file.
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…
No parameter schema on file.
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.
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
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.
No parameter schema on file.
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.
No parameter schema on file.
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…
No parameter schema on file.
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…
No parameter schema on file.
Create a PERSISTENT price alert tied to the user's OilPriceAPI account.
No parameter schema on file.
List all PERSISTENT price alerts on the user's OilPriceAPI account. Use when
No parameter schema on file.
Permanently delete a price alert from the user's OilPriceAPI account by id.
No parameter schema on file.
Get recent trigger activity for the user's price alerts — which alerts have
No parameter schema on file.
Get a multi-commodity market brief: latest spot prices, 24h changes,
No parameter schema on file.
Create a PERSISTENT, recurring price subscription (a 'watch') tied to the
No parameter schema on file.
List all PERSISTENT price subscriptions ('watches') on the user's
No parameter schema on file.
Permanently delete a price subscription ('watch') from the user's
No parameter schema on file.
Poll for new subscription events — the recurring snapshots recorded by the
No parameter schema on file.
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Oilpriceapi or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| verification-discount | source | publisher verification (provenance) — cryptographic build provenance ties the artifact to its source | −0 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
Tools were statically extracted from the published source (36 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| opa_get_product_facts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_price | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_market_overview | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_compare_prices | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_list_commodities | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_history | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_futures | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_futures_curve | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_natural_gas_hubs | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_marine_fuels | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_rig_counts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_drilling | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_diesel_by_state | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_fuel_surcharge | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_storage | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_opec_production | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_forecasts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_oil_inventories | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_well_permits | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_search_well_permits | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_lookup_well | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_well_activity | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_well_production | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_spread | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_account_status | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_plans | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_data_quality | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_create_price_alert | external-sink | external-sink: keyword "webhook", declares readOnlyHint: false, openWorldHint: true |
| opa_list_price_alerts | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_delete_price_alert | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| opa_get_alert_triggers | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_get_market_brief | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_create_price_subscription | external-sink | external-sink: declares readOnlyHint: false, openWorldHint: true |
| opa_list_subscriptions | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| opa_delete_subscription | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| opa_get_subscription_events | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 3.4.2. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
No release note was published with this version.
No release note was published with this version.
- The version this listing was on when mcprush began following its releases. The registry was not asked when it shipped, so this row carries no date.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Oilpriceapi can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.