io.github.OilpriceAPIPublished by GitHub account OilpriceAPIv0.1.2Updated Nov 11, 2026
Hosted energy prices: crude, gas, refined products, marine fuels, futures. Keyless demo.
The publisher's own server: PriceWin
Hosted OilPriceAPI connector giving an assistant source-timestamped energy prices: crude, gas, refined products, marine fuels and futures, with a keyless demo.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.OilpriceAPI%2Fhosted-energy/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"oilpriceapi-hosted-energy-data": {
"type": "http",
"url": "https://mcp.oilpriceapi.com/mcp"
}
}
}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.
Get a Free API Key · Documentation · API Explorer · Pricing
Backed by OilPriceAPI, a normalized REST API for energy dashboards, fleet and logistics tools, maritime workflows, and market research.
Canonical sources: Public product facts · Official MCP Registry record
The default scope is read-only. Account mutations are not listed and direct mutation calls are rejected unless write scope is explicitly enabled:
Inspect the package without opening an MCP stdio session:
--config generates client-native, copy/paste-valid JSON for
claude-desktop, claude-code, cursor, vscode, cline, or windsurf.
It never reads or prints the configured API key. Claude Code, VS Code, and
Windsurf outputs use their supported environment or secure-input references;
Claude Desktop, Cursor, and Cline use an explicit local replacement marker.
Add --demo to omit API-key configuration entirely. Scope, profile, and
category options are preserved in the generated server arguments.
Example commodity codes:
The server works out of the box in keyless demo mode — just omit OILPRICEAPI_KEY from the configs below. The price tools (opa_get_price, opa_compare_prices, opa_list_commodities, opa_market_overview) serve latest available values for a limited demo commodity set, and every other data tool explains its account requirements. Demo responses are marked with a footer. For the broader account-enabled catalog, history, futures, and alerts, get a free API key and add it to your config.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Add to your project's .mcp.json:
Add to .cursor/mcp.json in your project root:
Add to .vscode/mcp.json:
Add to ~/.codeium/windsurf/mcp_config.json:
Container builds require the source revision and commit timestamp so the image, capability manifest, and build metadata are traceable to the same checkout:
The runtime image uses the unprivileged node user. Omit OILPRICEAPI_KEY for
the limited keyless demo, or inject it with your container platform's secret
manager. Do not bake credentials into the image.
This server runs locally over stdio only. Its MCP Registry record lists the npm package and no remote endpoint.
The hosted connector at https://mcp.oilpriceapi.com/mcp is not this server.
It is a separate, smaller set of energy_* tools with OAuth account linking,
used by hosted clients that cannot launch a local process. Use this package for
the full opa_* tool set. The hosted connector has its own MCP Registry
record, io.github.OilpriceAPI/hosted-energy, defined in server.hosted.json
and published by the manual registry-hosted.yml workflow.
read scope includes all non-mutating tools, including alert history,
subscription listing, and subscription event polling. The four create/delete
tools require --scope write or OILPRICEAPI_MCP_SCOPE=write. Unknown scope,
profile, or category values fail closed before stdio starts.
Profiles reduce tool overload without replacing first-class MCP actions:
For example, a read-only price and product-facts server can use:
doctor checks the Node runtime, package entry point, API reachability, key
validity, current plan, and reported feature gates. doctor --demo performs a
bounded keyless request. Failures distinguish missing configuration, 401, 402,
403, 429, timeout, DNS/TLS, and upstream 5xx responses. The API key is never
printed.
Every package includes build/capabilities.json. It is generated from the same
SDK registry used by tools/list and records the package/version/source commit,
minimum Node version, scopes, profiles, exact inventories, per-tool annotations,
key/entitlement requirements, resources, commands, and support URLs. Website and
docs consumers should pin a package version, validate schemaVersion and
sourceCommit, and update the artifact only through an explicit dependency
upgrade. They should not scrape CLI prose or hard-code tool counts.
capability-ledger.json records an explicit decision for every operation in
the published OilPriceAPI contract (https://api.oilpriceapi.com/openapi.json).
Each operation is either exposed, naming the registered tool(s), or
not_exposed with a disposition (selected, deferred, alias,
unsupported, internal) and a one-line reason. Families group operations into
workflows, including preview API families the server calls that are not in the
canonical contract yet.
npm run build && npm run check:capability-ledger compares the ledger with the
live contract, build/capabilities.json and the REST paths src/index.ts
calls. It exits 1 on drift, such as a new API operation with no decision, a
removed one, or an unrecorded tool or path. It exits 2 when it cannot check: the
contract is unreachable, the build manifest is missing, or the route-policy
snapshot is older than its stated threshold. CI runs it on every pull request
and daily. When a decision changes, bump ledgerVersion, append to changes,
and link that change from the release notes.
All tools are prefixed with opa_ to avoid name collisions when multiple MCP servers are loaded.
These tools create and manage persistent price alerts tied to your OilPriceAPI account, so they require an API key (OILPRICEAPI_KEY). The alert engine evaluates eligible source updates and notifies you (by email, plus webhook if you provide one) when a condition is met.
The market brief gives a multi-commodity snapshot in one call. Subscriptions ("watches") are persistent, recurring snapshots tied to your account — the API records an event every interval, and the agent polls for new events via a per-user cursor (events are polled, not pushed — there is no always-on connection). These require an API key (OILPRICEAPI_KEY). A subscription differs from an alert: a watch always emits an event each interval (a running log), whereas an alert fires only on a threshold crossing. Per-account code, watch, and cadence limits apply; the API response is authoritative and returns the current limit when exceeded.
Subscribable price data (JSON):
opa_get_product_facts and oilpriceapi://product-facts improve accuracy for a connected MCP session. They do not retrain a model or update its general knowledge. The server prefers the canonical keyless contract, uses a bounded cache, and labels any checksum-verified package fallback with source and warning metadata.
Pre-built analyst templates:
--scope write or OILPRICEAPI_MCP_SCOPE=write.--list-tools --json or --capabilities --json instead of relying on a
hard-coded inventory.opa_ prefix (e.g., get_commodity_price -> opa_get_price)list_commodities now fetches live from the API (falls back to static list if unavailable)Same data, every stack:
This MCP server runs locally on your machine and only communicates with the OilPriceAPI service:
api.oilpriceapi.com (commodity codes, query parameters such as time period or state, carrier slugs and service-level inputs for fuel surcharges, and — for alert/subscription tools — the alert parameters you specify), authenticated with your API key. No conversation content is transmitted — only the structured tool inputs above.OILPRICEAPI_KEY environment variable). It is sent only to api.oilpriceapi.com as an Authorization header.provided. API request logging follows the OilPriceAPI Privacy Policy.Questions: [email protected]
Where the free/paid line sits for this server (#10):
MIT
Source: README.md at commit cba0efb
Get Energy Price
Read one supported latest energy benchmark. Preserve dataset name, currency, unit and all available source/freshness fields. Latest benchmarks may be futures; never relabel them spot or settlement. Demo is available without signup.
benchmarkrequiredEnergy Market Overview
Read a grouped snapshot of at most six supported energy benchmarks. Catalog enumeration and bulk extraction are outside this plugin. Missing values remain unavailable.
categoryrequiredCompare Energy Benchmarks
Compare 2–5 distinct supported energy benchmarks with separate timestamps, dataset context, units and currencies. No currency conversion or timestamp alignment is implied.
benchmarksrequiredEnergy Price History
Read one authenticated benchmark's daily historical observations over at most 30 days and 100 rows. No pagination or anonymous history. Derive summaries only from returned observations, which may be incomplete.
daysrequiredlimitrequiredbenchmarkrequiredFutures Curve
Read an authenticated energy forward curve, at most 12 contracts. Preserve contract month, trading date and expiration semantics. Missing expiration or source dates remain unreported. Account entitlement is enforced by OilPriceAPI.
limitrequiredinstrumentrequiredMarine Fuel Prices
Read authenticated bunker quotes for 1–2 supported ports and one exact grade: VLSFO, MGO_05S or HFO_380. Preserve port, grade and per-quote freshness. No substitution when a quote is unavailable. Account entitlement is enforced by OilPriceAPI.
graderequiredportsrequiredDrilling Activity
Read authenticated drilling intelligence for a supported geography. Preserve report dates and geography. Permian basin counts and prior-report changes are unavailable unless explicitly supplied; do not substitute US totals. Account entitlement is enforced by OilPriceAPI.
geographyrequiredSearch Commodity Catalog
Search the full OilPriceAPI commodity catalog (crude grades, regional natural gas hubs such as Waha, refined products, power, coal, metals, freight and more) by name or code. Returns at most 10 matching codes with name, category, unit and update frequency. Use it to find the code, then call energy_get_latest. Requires a connected OilPriceAPI account.
limitrequiredqueryrequiredGet Latest Price by Code
Read the latest price for one exact commodity code from the catalog (find codes with energy_search_catalog). Preserve dataset name, currency, unit and all source/freshness fields; latest is not necessarily spot or settlement. Requires a connected account; access follows the account's plan.
coderequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
win.priceOfficial publisher
Remote MCP server for live hotel and flight price comparison across Booking.com, Agoda, Trip.com, Traveloka and others, plus direct hotel booking requests.
Published by GitHub account travisjmurphy
Nine Canada-focused tools for building permits, corporations, recalls, charities, funding programs and retail prices, run through your own Apify account.
Published by GitHub account mohammad-abbasi-sh
Unofficial read-only MCP server that lets an assistant search billiger.de for German product prices, compare shop offers and list today's deals.
com.mambabuilt
Reads Amazon price, stock, seller and rating for ASINs or product URLs across 9 marketplaces, with change rows between runs.
Published by GitHub account theluckystrike
Remote MCP server that gives an assistant current USPS retail postage prices, read from USPS Notice 123 at call time, plus letter postage calculations.
npx oilpriceapi-mcpnpx oilpriceapi-mcp --scope writenpx oilpriceapi-mcp --versionnpx oilpriceapi-mcp --list-toolsnpx oilpriceapi-mcp --list-tools --json --profile corenpx oilpriceapi-mcp doctor --demonpx oilpriceapi-mcp doctornpx oilpriceapi-mcp --capabilities --jsonnpx oilpriceapi-mcp --config claude-codenpx oilpriceapi-mcp --config vscode{ "mcpServers": { "oilpriceapi": { "command": "npx", "args": ["-y", "oilpriceapi-mcp"], "env": { "OILPRICEAPI_KEY": "your-api-key-here" } } }}{ "mcpServers": { "oilpriceapi": { "command": "npx", "args": ["-y", "oilpriceapi-mcp"], "env": { "OILPRICEAPI_KEY": "your-api-key-here" } } }}{ "mcpServers": { "oilpriceapi": { "command": "npx", "args": ["-y", "oilpriceapi-mcp"], "env": { "OILPRICEAPI_KEY": "your-api-key-here" } } }}{ "servers": { "oilpriceapi": { "type": "stdio", "command": "npx", "args": ["-y", "oilpriceapi-mcp"], "env": { "OILPRICEAPI_KEY": "your-api-key-here" } } }}{ "mcpServers": { "oilpriceapi": { "command": "npx", "args": ["-y", "oilpriceapi-mcp"], "env": { "OILPRICEAPI_KEY": "your-api-key-here" } } }}npm install -g oilpriceapi-mcpdocker build \ --build-arg SOURCE_COMMIT="$(git rev-parse HEAD)" \ --build-arg SOURCE_DATE_EPOCH="$(git show -s --format=%ct HEAD)" \ -t oilpriceapi-mcp .docker run --rm oilpriceapi-mcp --versiondocker run --rm oilpriceapi-mcp --capabilities --json{ "command": "npx", "args": ["-y", "oilpriceapi-mcp", "--scope", "read", "--profile", "core"]}"What's the current Brent oil price?""Compare Brent and WTI crude""Show me oil prices for the past month""What's diesel cost in California vs Texas?""Give me a market overview of refined products""What's the Brent futures curve look like?""How many rigs are active in the US?""What are OPEC production levels?""What are bunker fuel prices in Singapore?""Show me Cushing storage levels""What were the latest EIA crude oil inventories?""How many well permits were issued in Texas?""What's the current 3-2-1 crack spread?""What's the UPS ground fuel surcharge?""Show me the gasoil futures curve"npm installnpm run buildnpm testOILPRICEAPI_KEY=your-key node build/index.js