OilPriceAPI — Real-Time Oil, Gas & Commodity Prices for AI Agents

OilPriceAPI MCP サーバー

MCP を通じて、互換性のある AI クライアントに、出典のタイムスタンプ付きの石油、ガス、LNG、炭素、燃料、および関連するエネルギーデータを提供します。制限付きデモは API キーなしでお試しいただけます。

無料 API キーを取得 · ドキュメント · API エクスプローラー · 料金

エネルギー関連のダッシュボード、車両管理・物流ツール、海運ワークフロー、市場調査向けに正規化された REST API、OilPriceAPI を基盤としています。

正式な情報源： 公開製品情報 · 公式 MCP Registry の記録

機能

• 確認済みの製品情報 — 提供内容、データの鮮度、認証、カタログ、利用権限、データの権利に関する質問に対応する、キー不要の読み取り専用ツールと安定したリソース
• データおよびワークフローツール — 最新値、履歴、先物、船舶燃料、燃料サーチャージ、エネルギーインテリジェンス、アラート、市場概要、永続的なウォッチ
• リソース — 確認済みの製品仕様と、購読可能な価格スナップショット
• プロンプト — 市場分析、スプレッド分析、ガスマーケット、ディーゼルコスト、供給分析向けのアナリスト用テンプレート
• 自然言語 — コードではなく、「brent oil」や「natural gas」のように指定できます
• 幅広いカタログ — 石油、ガス、石炭、石油精製製品、金属、外国為替、バンカー燃料、州別ディーゼル、および一部のエネルギーインテリジェンスデータセットに対応。利用可能なデータはプランとアカウントによって異なります
• スマートなエラー処理 — 認識されない商品には候補を提示し、黙って別の値に置き換えることはありません

クイックスタート

npx oilpriceapi-mcp

デフォルトのスコープは読み取り専用です。アカウントを変更する操作は一覧に含まれず、書き込みスコープが明示的に有効化されていない限り、変更操作の直接呼び出しは拒否されます。

npx oilpriceapi-mcp --scope write

MCP の stdio セッションを開始せずに、パッケージの内容を確認できます。

npx oilpriceapi-mcp --version
npx oilpriceapi-mcp --list-tools
npx oilpriceapi-mcp --list-tools --json --profile core
npx oilpriceapi-mcp doctor --demo
npx oilpriceapi-mcp doctor
npx oilpriceapi-mcp --capabilities --json
npx oilpriceapi-mcp --config claude-code
npx oilpriceapi-mcp --config vscode

--config は、claude-desktop、claude-code、cursor、vscode、cline、windsurf 向けに、各クライアントに適したコピー＆ペースト可能な JSON を生成します。設定済みの API キーを読み取ったり、表示したりすることはありません。Claude Code、VS Code、Windsurf の出力では、サポートされている環境変数またはセキュア入力の参照を使用します。Claude Desktop、Cursor、Cline では、明示的なローカル置換マーカーを使用します。API キーの設定を完全に省略するには、--demo を追加してください。スコープ、プロファイル、カテゴリのオプションは、生成されるサーバー引数に引き継がれます。

エージェントが取得できる情報

商品コードの例：

コード	内容	エージェントでの一般的な用途
BRENT_CRUDE_USD	ブレント原油（世界市場）	市場概要、ダッシュボード
WTI_USD	WTI 原油（米国）	取引の背景情報、マクロモデル
NATURAL_GAS_USD	ヘンリーハブ天然ガス	エネルギー分析
DUTCH_TTF_EUR	TTF ガス（欧州）	欧州エネルギー、LNG 分析
JKM_LNG_USD	JKM LNG（アジア）	LNG 取引・海運
EU_CARBON_EUR	EU ETS 炭素排出枠	CBAM、海運コンプライアンス、ESG
DIESEL_USD	ディーゼル（ガルフコースト）	車両管理・燃料サーチャージの計算
JET_FUEL_USD	ジェット燃料	航空運用
VLSFO_USD	船舶用バンカー燃料	航海コストの算出
GOLD_USD	金	マクロ・ポートフォリオの参考情報

インストール

API キーなしで試す

このサーバーは、キー不要のデモモードでそのまま動作します。以下の設定から OILPRICEAPI_KEY を省略するだけです。価格ツール（opa_get_price、opa_compare_prices、opa_list_commodities、opa_market_overview）では、限定されたデモ用商品セットの最新の利用可能な値を提供し、それ以外のデータツールではアカウント要件について説明します。デモの応答にはフッターが表示されます。より幅広いアカウント対応のカタログ、履歴、先物、アラートを利用するには、無料の API キーを取得し、設定に追加してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code + Cline

.vscode/mcp.json に追加します。

{
  "servers": {
    "oilpriceapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "oilpriceapi": {
      "command": "npx",
      "args": ["-y", "oilpriceapi-mcp"],
      "env": {
        "OILPRICEAPI_KEY": "your-api-key-here"
      }
    }
  }
}

グローバルインストール

npm install -g oilpriceapi-mcp

コンテナーのビルド

コンテナーのビルドでは、イメージ、機能マニフェスト、ビルドメタデータを同じチェックアウトに関連付けて追跡できるように、ソースリビジョンとコミットのタイムスタンプが必要です。

docker 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 --version
docker run --rm oilpriceapi-mcp --capabilities --json

ランタイムイメージでは、権限のない node ユーザーを使用します。キー不要の限定デモを利用する場合は OILPRICEAPI_KEY を省略するか、コンテナープラットフォームのシークレットマネージャーを使って注入してください。認証情報をイメージに埋め込まないでください。

トランスポート

このサーバーは、stdio 経由でローカル実行する場合にのみ動作します。MCP Registry のレコードには npm パッケージが記載されており、リモートエンドポイントはありません。

ホスト型コネクター https://mcp.oilpriceapi.com/mcp は、このサーバーではありません。これは、OAuth アカウント連携に対応した energy_* ツールのみを提供する別の小規模なセットで、ローカルプロセスを起動できないホスト型クライアントが使用します。opa_* ツール一式を利用するには、このパッケージを使用してください。

環境変数

変数	必須	説明
OILPRICEAPI_KEY	いいえ	oilpriceapi.com/auth/signup で取得する API キーです。コアトライアルの終了後は、現在の Free の利用枠とリセット期間を確認するために、公開されている製品情報またはアカウントの応答を参照してください。データセットへのアクセスと制限は、プランと利用権限によって異なります。キーがない場合、サーバーは制限付きのデモを使用します。
OILPRICEAPI_BASE_URL	いいえ	API のベース URL を上書きします（ステージング／テスト用）。デフォルト：https://api.oilpriceapi.com
OILPRICEAPI_MCP_SCOPE	いいえ	read（デフォルト）では、作成／削除ツールが非表示になり、ブロックされます。アカウントの変更を行う場合にのみ、write を設定してください。
OILPRICEAPI_MCP_PROFILE	いいえ	安定したツール構成プロファイルです：all（デフォルト）、core、market、または automation。
OILPRICEAPI_MCP_CATEGORIES	いいえ	カンマ区切りのカテゴリ許可リスト（core、market、automation）です。選択したプロファイルより優先されます。

ツールのスコープとプロファイル

read スコープには、アラート履歴、サブスクリプション一覧、サブスクリプションイベントのポーリングを含む、状態を変更しないすべてのツールが含まれます。4 つの作成／削除ツールを使用するには、--scope write または OILPRICEAPI_MCP_SCOPE=write が必要です。不明なスコープ、プロファイル、またはカテゴリの値が指定された場合、stdio の起動前に処理を拒否します。

プロファイルを使うと、MCP の主要なアクションを置き換えることなく、ツールの過剰な表示を減らせます：

プロファイル	含まれるカテゴリ
all	core、market、automation
core	core
market	core、market
automation	core、automation

たとえば、読み取り専用の価格・製品情報サーバーには、次の設定を使用できます：

{
  "command": "npx",
  "args": ["-y", "oilpriceapi-mcp", "--scope", "read", "--profile", "core"]
}

Doctor と機能契約

doctor は、Node ランタイム、パッケージのエントリーポイント、API の到達可能性、キーの有効性、現在のプラン、報告された機能ゲートを確認します。doctor --demo は、範囲を限定したキー不要のリクエストを実行します。失敗は、設定の欠落、401、402、403、429、タイムアウト、DNS/TLS、上流の 5xx レスポンスに分類されます。API キーは表示されません。

すべてのパッケージには build/capabilities.json が含まれます。このファイルは、tools/list で使用されるものと同じ SDK レジストリから生成され、パッケージ／バージョン／ソースコミット、最低 Node バージョン、スコープ、プロファイル、正確なインベントリ、ツールごとのアノテーション、キー／利用資格の要件、リソース、コマンド、サポート URL を記録します。Web サイトやドキュメントの利用者は、パッケージのバージョンを固定し、schemaVersion と sourceCommit を検証したうえで、明示的な依存関係のアップグレード時にのみアーティファクトを更新してください。CLI の説明文をスクレイピングしたり、ツール数をハードコードしたりしないでください。

API と MCP の機能対応台帳

capability-ledger.json は、公開されている OilPriceAPI の契約（https://api.oilpriceapi.com/openapi.json）に含まれるすべての操作について、明示的な判断を記録します。各操作は、登録済みのツール名を示す exposed、または処置（selected、deferred、alias、unsupported、internal）と理由を1行で示す not_exposed のいずれかです。ファミリーは操作をワークフローごとにまとめ、サーバーが呼び出すものの、まだ正式な契約に含まれていないプレビュー API ファミリーも含みます。

npm run build && npm run check:capability-ledger は、この台帳をライブ契約、build/capabilities.json、および src/index.ts が呼び出す REST パスと照合します。判断のない新しい API 操作、削除された操作、未記録のツールやパスなどの不整合がある場合は、終了コード 1 で終了します。契約に到達できない場合、ビルドマニフェストが見つからない場合、またはルートポリシーのスナップショットが規定のしきい値より古い場合は、確認できないことを示す終了コード 2 で終了します。CI はすべてのプルリクエストで、また毎日この処理を実行します。判断を変更する場合は、ledgerVersion を更新し、changes に追記したうえで、その変更へのリンクをリリースノートに追加してください。

ツール

複数の MCP サーバーを読み込んだ場合の名前の衝突を避けるため、すべてのツールには opa_ が接頭辞として付いています。

ツール	説明
opa_get_product_facts	レビュー済みの製品、オファー、鮮度、認証、統合、利用権、およびデータ権利に関する契約
opa_get_price	1つのコモディティの現在のスポット価格
opa_market_overview	APIが返す、アカウントから参照可能な現在の価格をカテゴリー別にグループ化
opa_compare_prices	2～5種類のコモディティをスプレッドとともに並べて比較
opa_list_commodities	ライブAPIが返す、アカウントから参照可能なコモディティカタログ
opa_get_history	高値／安値／平均／変動を含む過去の価格（日／週／月／年）
opa_get_history_range	開始日／終了日の範囲における1～5種類のコモディティの日時付き価格行。1時間単位から月単位まで、ページ分割に対応
opa_get_futures	限月先物（Brent、WTI、gasoil、TTF、JKM、EU carbon）
opa_get_futures_curve	コンタンゴ／バックワーデーション分析を含む完全な先物カーブ
opa_get_futures_history	契約月ごとのBrent、WTI、NYMEX natural gasのOHLC履歴。最大730日
opa_get_marine_fuels	港と燃料の種類（VLSFO/MGO/IFO380）別の船舶用燃料価格
opa_get_marine_ports	バンカリング港の一覧（UN/LOCODE、地域、燃料サービス）、または最近の価格を含む1つの港
opa_get_marine_fuel_history	1つの港における1種類の船舶用燃料の日次履歴。有料サブスクリプションまたは有効なトライアルが必要
opa_get_rig_counts	地域と観測日を含む、Baker Hughesの米国総掘削リグ数
opa_get_drilling	掘削状況のスナップショット：掘削リグ数、破砕作業隊、30日間の許可、DUC
opa_get_diesel_by_state	米国の任意の州（50州とDC）のAAA小売ディーゼル価格
opa_get_fuel_surcharge	LTLおよび小口配送業者の燃料サーチャージ率。有効日と情報源の来歴を含む
opa_get_storage	CushingとSPRの石油貯蔵量／在庫水準
opa_get_opec_production	OPECの国別生産データ
opa_get_forecasts	EIA STEOのエネルギー価格予測
opa_get_oil_inventories	EIAの週次石油在庫（latest/summary/by_product）
opa_get_well_permits	米国の油井掘削許可（latest/by_state/by_operator）
opa_search_well_permits	州を指定した、郡／事業者／日付による許可の検索。鮮度を測定するゲート付き
opa_lookup_well	API番号による検索。利用可能な場合は、昇格されたライフサイクル情報と正確な月次生産量を含む
opa_get_well_activity	最近の許可件数／主要事業者／傾向。州の健全性に関する明示的な警告を含む
opa_get_well_production	米国の油井生産 — ベータ版の対応範囲（summary/states/state/well/top_producers/cycle_time/cohorts）
opa_get_spread	クラック（type、crude）、ベーシス（pair、または全ペア）、マージン（index）。日付範囲の履歴は任意
opa_get_natural_gas_hubs	米国の現物ガスハブ価格をHenry Hubに対するベーシスとして提供（Waha、SoCal、Chicagoなど）
opa_get_data_quality	OilPriceAPI独自の系列ごとのデータ品質グレード（完全性、鮮度など）
opa_get_account_status	設定済みキーのプラン階層、リクエスト使用量、残りの割り当て量、リセット日
opa_get_plans	現在のサブスクリプションプラン：価格、リクエスト上限、含まれる機能

価格アラートツール（認証済み）

これらのツールは、OilPriceAPI アカウントに紐づく永続的な価格アラートを作成、管理するため、API キー（OILPRICEAPI_KEY）が必要です。アラートエンジンは条件を満たすソースの更新を評価し、条件が満たされると（メールで、Webhook を指定した場合は Webhook でも）通知します。

ツール	説明
opa_create_price_alert	永続的なアラートを作成します（商品、演算子、しきい値、任意の Webhook）
opa_list_price_alerts	アカウント上のすべてのアラートを一覧表示します
opa_delete_price_alert	ID を指定してアラートを完全に削除します
opa_get_alert_triggers	最近のアラート発火履歴（since で任意に絞り込み可能）

市場概要・サブスクリプションツール（認証済み）

市場概要では、1 回の呼び出しで複数の商品をまとめて確認できます。サブスクリプション（「ウォッチ」）は、アカウントに紐づく永続的で定期的なスナップショットです。API は各間隔でイベントを記録し、エージェントはユーザーごとのカーソルを使って新しいイベントをポーリングします（イベントはポーリングされるものであり、プッシュされるものではありません。常時接続はありません）。これらにはAPI キー（OILPRICEAPI_KEY）が必要です。サブスクリプションはアラートとは異なります。ウォッチは各間隔で常にイベントを出力します（継続的なログ）が、アラートはしきい値を超えたときにのみ発火します。アカウントごとにコード、ウォッチ、間隔の上限が適用されます。上限を超えた場合、API の応答が正式な情報となり、現在の上限が返されます。

ツール	説明
opa_get_market_brief	複数商品の概要：価格、24 時間の変動、1 か月予測、スプレッド、任意の解説
opa_create_price_subscription	永続的な定期ウォッチを作成します（コード、5m／1h／daily などの間隔）
opa_list_subscriptions	アカウント上のすべてのサブスクリプションを一覧表示します
opa_delete_subscription	ID を指定してサブスクリプションを完全に削除します
opa_get_subscription_events	カーソル（since）以降の新しいウォッチイベントをポーリングします（スナップショットと差分を返します）

質問の例

"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"

リソース

購読可能な価格データ（JSON）：

リソース	URI	説明
製品情報	oilpriceapi://product-facts	レビュー済みで、バージョン管理された公開製品仕様
ブレント原油	price://brent	世界的な原油価格のベンチマーク
WTI 原油	price://wti	米国の原油価格のベンチマーク
天然ガス	price://natural-gas	米国ヘンリーハブ天然ガス価格
ディーゼル	price://diesel	米国のディーゼル価格の全国平均
市場ビュー	price://all	API から取得できる、アカウントに表示可能な現在の価格

製品情報とモデルの知識

opa_get_product_facts と oilpriceapi://product-facts は、接続された MCP セッションの精度を高めます。モデルを再トレーニングしたり、一般的な知識を更新したりするものではありません。サーバーは正規のキー不要の仕様を優先し、上限付きキャッシュを使用します。また、チェックサムで検証されたパッケージのフォールバックには、ソースと警告のメタデータを付与します。

プロンプト

事前構築済みのアナリスト用テンプレート：

プロンプト	説明
daily-briefing	主要価格と値動きをまとめた、エネルギー市場の日次ブリーフィング
brent-wti-spread	Brent-WTI 原油スプレッドを分析します
gas-market-analysis	米国と欧州の天然ガス市場を比較します
commodity-report	特定の商品に関する詳細レポート（パラメーター指定可能）
diesel-cost-analysis	フリート計画向けに、米国各州のディーゼル価格を比較します
supply-analysis	OPEC の生産量、リグ数、貯蔵量を使って供給を分析します

自然言語のサポート

入力例	解釈される内容
"brent oil", "brent crude"	BRENT_CRUDE_USD
"wti", "us oil"	WTI_USD
"natural gas", "henry hub"	NATURAL_GAS_USD
"european gas", "ttf"	DUTCH_TTF_EUR
"diesel"	DIESEL_USD
"gold"	GOLD_USD
"jet fuel", "aviation fuel"	JET_FUEL_USD
"carbon", "carbon credits"	EU_CARBON_EUR

開発

npm install
npm run build
npm test
OILPRICEAPI_KEY=your-key node build/index.js

v3.0.0 の破壊的変更

• デフォルトのツールスコープが読み取り専用になりました。アラートとサブスクリプションの作成・削除ツールを使用するには、明示的に --scope write または OILPRICEAPI_MCP_SCOPE=write を指定してください。
• 無効なスコープ／プロファイル／カテゴリー設定は、MCP の stdio 起動前にエラーになります。
• 固定のツール一覧に依存する代わりに、--list-tools --json または --capabilities --json を使用してください。

v2.0.0 の破壊的変更

• すべてのツール名に opa_ プレフィックスが付くようになりました（例：get_commodity_price → opa_get_price）
• 認識されない商品名は、Brent に暗黙に置き換えられるのではなく、候補を提示するエラーを返すようになりました
• list_commodities は API からリアルタイムで取得するようになりました（利用できない場合は静的リストにフォールバックします）

OilPriceAPI のツールボックス全体

同じデータを、あらゆるスタックで利用できます：

ツール	インストール
Python SDK	pip install oilpriceapi
Node/TypeScript SDK	npm install oilpriceapi
PHP SDK	composer require oilpriceapi/oilpriceapi
Go SDK	go get github.com/OilpriceAPI/oilpriceapi-go
WordPress plugin	コード不要の価格ウィジェット

API を探索する

• 🧭 インタラクティブエクスプローラー：api.oilpriceapi.com/swagger — ブラウザーですべてのエンドポイントを試せます（デモモードではキー不要です）
• 📜 OpenAPI 仕様：swagger.json

プライバシーポリシー

この MCP サーバーはお使いのマシン上でローカルに実行され、OilPriceAPI サービスとのみ通信します。

• 送信される情報：ツールのリクエストは、api.oilpriceapi.com への HTTPS 呼び出しに変換されます（商品コード、期間や州などのクエリパラメーター、運賃割増料金用の運送業者のスラッグとサービスレベルの入力値、およびアラート／サブスクリプションツールの場合は指定したアラートパラメーター）。これらの呼び出しは API キーで認証されます。会話の内容は送信されません。送信されるのは、上記の構造化されたツール入力のみです。
• API キーの保存：キーは MCP クライアントの設定、または OILPRICEAPI_KEY 環境変数にローカル保存されます。キーの送信先は api.oilpriceapi.com のみで、Authorization ヘッダーに含められます。
• ログ記録と需要テレメトリ：各ツールは、stderr にローカルの構造化されたヒット／ミスイベントを出力し、ツール名と意図的に情報を一部失わせた引数の形式を使って API リクエストを記録します。商品コード、間隔、州コード、範囲を制限した数値制御値は保持される場合があります。自由記述テキスト、プロンプト、名前、ID、API の油井番号、座標、しきい値は provided に置き換えられます。API リクエストのログ記録については、OilPriceAPI プライバシーポリシーに従います。
• 第三者：同ポリシーに記載されている場合を除き、第三者とデータを共有することはありません。
• デモモード：API キーがない場合、価格ツールは同じホスト上のキー不要のデモエンドポイントを呼び出します。キーやアカウントデータは関与しません。

お問い合わせ：[email protected]

料金の境界（HTTP 402）

このサーバーにおける無料／有料の境界について（#10）：

• 常に無料：MCP サーバー本体（MIT）、セットアップ、ドキュメント、ツール一覧表示などの検索機能、および少量利用の評価向けキー不要のデモモード。
• API キー：現在のトライアル、利用枠、リセット期間、データセットの利用権については、公開されている製品情報とアカウントの応答を確認してください。キー不要のデモモードでは、引き続き限定的なデータセットを利用できます。
• 有料の機能：大量利用とプレミアムデータセット（先物、エネルギーインテリジェンス、油井の許可・生産データ、大規模なアラート）。リクエストがこの境界を超えると、API は本文に制限や機能制限の正確な内容を含めた標準的な HTTP 402/403/429 を返します。このサーバーはそのメッセージとアップグレードリンクを表示するため、エージェントは機械可読な停止通知を受け取り、エラーが黙って処理されることはありません。
• x402 プロトコル：x402 プロトコルによるリクエストごとの暗号資産マイクロペイメントには、現在対応していません。支払いはアカウントプラン（Stripe）を通じて行い、API キーで認証します。

ライセンス

MIT

リンク

• OilPriceAPI
• API ドキュメント
• 料金
• MCP プロトコル

以下の形式でも利用できます

• Python SDK - Pandas 連携に対応した Python クライアント
• Node.js SDK - TypeScript／JavaScript SDK
• Go SDK - Go の慣用的な書き方に沿ったクライアント
• OpenBB 連携 - OpenBB Platform プロバイダー