oilpriceapi-mcp 1.1.1 → 2.0.0

package/README.md

@@ -7,11 +7,12 @@
 
 ## Features
 
-- **4 Tools** — get prices, market overviews, price comparisons, commodity listings
-- **4 Resources** — subscribable price snapshots for Brent, WTI, Natural Gas, and all commodities
-- **4 Prompts** — pre-built analyst templates (daily briefing, spread analysis, gas market, commodity report)
+- **14 Tools** — spot prices, history, futures, marine fuels, rig counts, diesel by state, storage, OPEC production, forecasts
+- **5 Resources** — subscribable price snapshots for Brent, WTI, Natural Gas, Diesel, and all commodities
+- **6 Prompts** — pre-built analyst templates (daily briefing, spread analysis, gas markets, commodity report, diesel costs, supply analysis)
 - **Natural language** — ask for "brent oil" or "natural gas", not codes
-- **40+ commodities** — oil, gas, coal, refined products, metals, forex
+- **70+ commodities** — oil, gas, coal, refined products, metals, forex, bunker fuels, state diesel
+- **Smart errors** — unrecognized commodities get suggestions, not silent fallbacks
 
 ## Quick Start
 
@@ -118,45 +119,49 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 npm install -g oilpriceapi-mcp
 ```
 
-## Getting an API Key
+## Environment Variables
 
-1. Sign up at [oilpriceapi.com](https://oilpriceapi.com)
-2. Get your API key from the dashboard
-3. Add it to your MCP config as shown above
+| Variable               | Required | Description                                                                                                                                                 |
+| ---------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `OILPRICEAPI_KEY`      | Yes      | API key from [oilpriceapi.com/signup](https://www.oilpriceapi.com/signup?utm_source=npm&utm_medium=mcp&utm_campaign=readme). Free tier: 200 requests/month. |
+| `OILPRICEAPI_BASE_URL` | No       | Override API base URL (for staging/testing). Default: `https://api.oilpriceapi.com`                                                                         |
 
 ## Tools
 
-### `get_commodity_price`
-
-Get the current price of a specific commodity.
+All tools are prefixed with `opa_` to avoid name collisions when multiple MCP servers are loaded.
+
+| Tool                      | Description                                                      |
+| ------------------------- | ---------------------------------------------------------------- |
+| `opa_get_price`           | Current spot price for a single commodity                        |
+| `opa_market_overview`     | All commodity prices in one call, grouped by category            |
+| `opa_compare_prices`      | Side-by-side comparison of 2-5 commodities with spread           |
+| `opa_list_commodities`    | Full commodity catalog (fetched live from API)                   |
+| `opa_get_history`         | Historical prices with high/low/avg/change (day/week/month/year) |
+| `opa_get_futures`         | Front-month futures price (Brent BZ or WTI CL)                   |
+| `opa_get_futures_curve`   | Full forward curve with contango/backwardation analysis          |
+| `opa_get_marine_fuels`    | Bunker fuel prices by port and fuel type (VLSFO/MGO/IFO380)      |
+| `opa_get_rig_counts`      | Baker Hughes US rig count with week-over-week change             |
+| `opa_get_drilling`        | Drilling intelligence: wells, permits, completions by region     |
+| `opa_get_diesel_by_state` | AAA retail diesel price for any US state (50 states + DC)        |
+| `opa_get_storage`         | Cushing and SPR oil storage/inventory levels                     |
+| `opa_get_opec_production` | OPEC country-level production data                               |
+| `opa_get_forecasts`       | EIA STEO energy price forecasts                                  |
+
+## Example Questions
 
 ```
 "What's the current Brent oil price?"
-"Get the price of natural gas"
-```
-
-### `get_market_overview`
-
-Get prices for all commodities, optionally filtered by category (`oil`, `gas`, `coal`, `refined`, `all`).
-
-```
-"Give me a market overview"
-"Show all oil prices"
-```
-
-### `compare_prices`
-
-Compare prices between 2-5 commodities.
-
-```
-"Compare Brent and WTI prices"
-"What's the spread between US and European gas?"
+"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 oil rigs are active in the US?"
+"What are OPEC production levels?"
+"What are bunker fuel prices in Singapore?"
+"Show me Cushing storage levels"
 ```
 
-### `list_commodities`
-
-List all available commodities and their codes.
-
 ## Resources
 
 Subscribable price data (JSON):
@@ -166,72 +171,64 @@ Subscribable price data (JSON):
 | Brent Crude | `price://brent`       | Global benchmark crude oil price |
 | WTI Crude   | `price://wti`         | US benchmark crude oil price     |
 | Natural Gas | `price://natural-gas` | US Henry Hub natural gas price   |
+| Diesel      | `price://diesel`      | US national average diesel price |
 | All Prices  | `price://all`         | All tracked commodity prices     |
 
 ## Prompts
 
 Pre-built analyst templates:
 
-| Prompt                | Description                                             |
-| --------------------- | ------------------------------------------------------- |
-| `daily-briefing`      | Energy market daily briefing with key prices and movers |
-| `brent-wti-spread`    | Analyze the Brent-WTI crude oil spread                  |
-| `gas-market-analysis` | Compare US vs European natural gas markets              |
-| `commodity-report`    | Detailed report on a specific commodity (parameterized) |
-
-## Supported Commodities
-
-### Crude Oil
-
-- Brent Crude (global benchmark)
-- WTI (US benchmark)
-- Urals (Russian)
-- Dubai (Middle East)
-
-### Natural Gas
-
-- US Henry Hub ($/MMBtu)
-- UK NBP (pence/therm)
-- European TTF (EUR/MWh)
-
-### Coal
-
-- Thermal Coal
-- Newcastle Coal (Asia-Pacific)
-
-### Refined Products
-
-- Diesel, Gasoline, RBOB Gasoline, Jet Fuel, Heating Oil
-
-### Other
-
-- Gold, EU Carbon Allowances, EUR/USD, GBP/USD
+| Prompt                 | Description                                               |
+| ---------------------- | --------------------------------------------------------- |
+| `daily-briefing`       | Energy market daily briefing with key prices and movers   |
+| `brent-wti-spread`     | Analyze the Brent-WTI crude oil spread                    |
+| `gas-market-analysis`  | Compare US vs European natural gas markets                |
+| `commodity-report`     | Detailed report on a specific commodity (parameterized)   |
+| `diesel-cost-analysis` | Compare diesel prices across US states for fleet planning |
+| `supply-analysis`      | Analyze supply using OPEC production, rig counts, storage |
 
 ## Natural Language Support
 
-| You say                    | We understand   |
-| -------------------------- | --------------- |
-| "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        |
+| You say                     | We understand   |
+| --------------------------- | --------------- |
+| "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   |
 
 ## Development
 
 ```bash
 npm install
 npm run build
+npm test
 OILPRICEAPI_KEY=your-key node build/index.js
 ```
 
+## Breaking Changes in v2.0.0
+
+- All tool names now use `opa_` prefix (e.g., `get_commodity_price` -> `opa_get_price`)
+- Unrecognized commodity names now return an error with suggestions instead of silently defaulting to Brent
+- `list_commodities` now fetches live from the API (falls back to static list if unavailable)
+
 ## License
 
 MIT
 
 ## Links
 
-- [OilPriceAPI](https://oilpriceapi.com)
+- [OilPriceAPI](https://www.oilpriceapi.com)
 - [API Documentation](https://docs.oilpriceapi.com)
+- [Pricing](https://www.oilpriceapi.com/pricing?utm_source=npm&utm_medium=mcp&utm_campaign=pricing)
 - [MCP Protocol](https://modelcontextprotocol.io)
+
+## Also Available As
+
+- **[Python SDK](https://pypi.org/project/oilpriceapi/)** - Python client with Pandas integration
+- **[Node.js SDK](https://www.npmjs.com/package/oilpriceapi)** - TypeScript/JavaScript SDK
+- **[Go SDK](https://github.com/OilpriceAPI/oilpriceapi-go)** - Idiomatic Go client
+- **[OpenBB Integration](https://pypi.org/project/openbb-oilpriceapi/)** - OpenBB Platform provider

package/build/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/build/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/build/__tests__/index.test.js

@@ -0,0 +1,362 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { resolveCommodityCode, resolveStateCode, formatPrice, makeApiRequest, COMMODITY_ALIASES, COMMODITY_INFO, } from "../index.js";
+// ---------------------------------------------------------------------------
+// resolveCommodityCode
+// ---------------------------------------------------------------------------
+describe("resolveCommodityCode", () => {
+    it("resolves 'brent' alias to BRENT_CRUDE_USD", () => {
+        expect(resolveCommodityCode("brent")).toBe("BRENT_CRUDE_USD");
+    });
+    it("resolves 'brent crude' alias to BRENT_CRUDE_USD", () => {
+        expect(resolveCommodityCode("brent crude")).toBe("BRENT_CRUDE_USD");
+    });
+    it("resolves 'natural gas' alias to NATURAL_GAS_USD", () => {
+        expect(resolveCommodityCode("natural gas")).toBe("NATURAL_GAS_USD");
+    });
+    it("resolves 'wti' alias to WTI_USD", () => {
+        expect(resolveCommodityCode("wti")).toBe("WTI_USD");
+    });
+    it("passes through a valid commodity code unchanged (WTI_USD)", () => {
+        expect(resolveCommodityCode("WTI_USD")).toBe("WTI_USD");
+    });
+    it("passes through a valid commodity code regardless of case (wti_usd)", () => {
+        expect(resolveCommodityCode("wti_usd")).toBe("WTI_USD");
+    });
+    it("passes through BRENT_CRUDE_USD unchanged", () => {
+        expect(resolveCommodityCode("BRENT_CRUDE_USD")).toBe("BRENT_CRUDE_USD");
+    });
+    it("returns null for unknown input", () => {
+        expect(resolveCommodityCode("unknown_commodity_xyz")).toBeNull();
+    });
+    it("returns null for garbage input", () => {
+        expect(resolveCommodityCode("!!!")).toBeNull();
+    });
+    it("resolves case-insensitive alias ('BRENT')", () => {
+        expect(resolveCommodityCode("BRENT")).toBe("BRENT_CRUDE_USD");
+    });
+    it("resolves 'ttf' alias to DUTCH_TTF_EUR", () => {
+        expect(resolveCommodityCode("ttf")).toBe("DUTCH_TTF_EUR");
+    });
+    it("resolves 'gold' alias to GOLD_USD", () => {
+        expect(resolveCommodityCode("gold")).toBe("GOLD_USD");
+    });
+    it("resolves 'carbon' alias to EU_CARBON_EUR", () => {
+        expect(resolveCommodityCode("carbon")).toBe("EU_CARBON_EUR");
+    });
+});
+// ---------------------------------------------------------------------------
+// resolveStateCode
+// ---------------------------------------------------------------------------
+describe("resolveStateCode", () => {
+    it("resolves a 2-letter code ('CA')", () => {
+        expect(resolveStateCode("CA")).toBe("CA");
+    });
+    it("resolves lowercase 2-letter code ('tx')", () => {
+        expect(resolveStateCode("tx")).toBe("TX");
+    });
+    it("resolves full state name ('California')", () => {
+        expect(resolveStateCode("California")).toBe("CA");
+    });
+    it("resolves multi-word state name ('New York')", () => {
+        expect(resolveStateCode("New York")).toBe("NY");
+    });
+    it("resolves 'district of columbia' to DC", () => {
+        expect(resolveStateCode("district of columbia")).toBe("DC");
+    });
+    it("returns null for invalid 2-letter code", () => {
+        expect(resolveStateCode("ZZ")).toBeNull();
+    });
+    it("returns null for unrecognized input", () => {
+        expect(resolveStateCode("Middle Earth")).toBeNull();
+    });
+});
+// ---------------------------------------------------------------------------
+// formatPrice
+// ---------------------------------------------------------------------------
+describe("formatPrice", () => {
+    it("formats a USD price with all fields", () => {
+        const data = {
+            code: "BRENT_CRUDE_USD",
+            price: 85.42,
+            currency: "USD",
+            change_24h: 1.23,
+            change_24h_percent: 1.46,
+            updated_at: "2024-01-15T10:30:00Z",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("Brent Crude Oil");
+        expect(result).toContain("$85.42");
+        expect(result).toContain("barrel");
+        expect(result).toContain("+$1.23");
+        expect(result).toContain("+1.46%");
+        expect(result).toContain("Updated:");
+    });
+    it("formats a price with missing change fields", () => {
+        const data = {
+            code: "WTI_USD",
+            price: 80.0,
+            currency: "USD",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("WTI Crude Oil");
+        expect(result).toContain("$80.00");
+        expect(result).not.toContain("24h Change");
+        expect(result).not.toContain("Updated:");
+    });
+    it("formats negative 24h change correctly", () => {
+        const data = {
+            code: "BRENT_CRUDE_USD",
+            price: 83.0,
+            currency: "USD",
+            change_24h: -2.5,
+            change_24h_percent: -2.93,
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("-$2.50");
+        expect(result).toContain("-2.93%");
+        expect(result).not.toMatch(/\+\$-/);
+    });
+    it("formats EUR currency with euro symbol", () => {
+        const data = {
+            code: "EU_CARBON_EUR",
+            price: 62.5,
+            currency: "EUR",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("€62.50");
+        expect(result).not.toContain("$62.50");
+    });
+    it("formats GBP currency with pound symbol", () => {
+        const data = {
+            code: "NATURAL_GAS_GBP",
+            price: 75.3,
+            currency: "GBP",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("£75.30");
+        expect(result).not.toContain("$75.30");
+    });
+    it("formats GBp (pence) currency with pound symbol", () => {
+        const data = {
+            code: "NATURAL_GAS_GBP",
+            price: 80.0,
+            currency: "GBp",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("£80.00");
+    });
+    it("uses created_at as fallback timestamp when updated_at is absent", () => {
+        const data = {
+            code: "BRENT_CRUDE_USD",
+            price: 85.0,
+            currency: "USD",
+            created_at: "2024-03-01T08:00:00Z",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("Updated:");
+    });
+    it("handles unknown code gracefully (falls back to code as name)", () => {
+        const data = {
+            code: "SOME_UNKNOWN_CODE",
+            price: 100.0,
+            currency: "USD",
+        };
+        const result = formatPrice(data);
+        expect(result).toContain("SOME_UNKNOWN_CODE");
+        expect(result).toContain("$100.00");
+    });
+});
+// ---------------------------------------------------------------------------
+// makeApiRequest — basic success/failure (no retries, no delays)
+// ---------------------------------------------------------------------------
+describe("makeApiRequest - basic", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns parsed data on a successful 200 response", async () => {
+        const mockPayload = { status: "success", data: { price: 85.42 } };
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => mockPayload,
+            headers: { get: () => null },
+        });
+        const result = await makeApiRequest("/v1/prices/latest?by_code=BRENT_CRUDE_USD", mockFetch);
+        expect(result).toEqual(mockPayload);
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+    });
+    it("returns null on 401 without retrying", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            statusText: "Unauthorized",
+            headers: { get: () => null },
+        });
+        const result = await makeApiRequest("/v1/prices/latest", mockFetch);
+        expect(result).toBeNull();
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+    });
+});
+// ---------------------------------------------------------------------------
+// makeApiRequest — retry behaviour (fake timers to avoid slow waits)
+// ---------------------------------------------------------------------------
+describe("makeApiRequest - retry behaviour", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    async function runWithFakeTimers(endpoint, mockFetch) {
+        const promise = makeApiRequest(endpoint, mockFetch);
+        await vi.runAllTimersAsync();
+        return promise;
+    }
+    it("returns null on 429 after exhausting all retries", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 429,
+            statusText: "Too Many Requests",
+            headers: { get: () => null },
+        });
+        const result = await runWithFakeTimers("/v1/prices/latest", mockFetch);
+        expect(result).toBeNull();
+        expect(mockFetch).toHaveBeenCalledTimes(4);
+    });
+    it("returns null on network error after exhausting all retries", async () => {
+        const mockFetch = vi
+            .fn()
+            .mockRejectedValue(new Error("Network connection refused"));
+        const result = await runWithFakeTimers("/v1/prices/latest", mockFetch);
+        expect(result).toBeNull();
+        expect(mockFetch).toHaveBeenCalledTimes(4);
+    });
+    it("succeeds on second attempt after initial 429", async () => {
+        const mockPayload = { status: "success", data: { price: 82.0 } };
+        const mockFetch = vi
+            .fn()
+            .mockResolvedValueOnce({
+            ok: false,
+            status: 429,
+            statusText: "Too Many Requests",
+            headers: { get: () => null },
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => mockPayload,
+            headers: { get: () => null },
+        });
+        const result = await runWithFakeTimers("/v1/prices/latest", mockFetch);
+        expect(result).toEqual(mockPayload);
+        expect(mockFetch).toHaveBeenCalledTimes(2);
+    });
+    it("succeeds after two 500 errors then a 200", async () => {
+        const mockPayload = { status: "success", data: { price: 79.0 } };
+        const mockFetch = vi
+            .fn()
+            .mockResolvedValueOnce({
+            ok: false,
+            status: 500,
+            statusText: "Internal Server Error",
+            headers: { get: () => null },
+        })
+            .mockResolvedValueOnce({
+            ok: false,
+            status: 500,
+            statusText: "Internal Server Error",
+            headers: { get: () => null },
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => mockPayload,
+            headers: { get: () => null },
+        });
+        const result = await runWithFakeTimers("/v1/prices/latest", mockFetch);
+        expect(result).toEqual(mockPayload);
+        expect(mockFetch).toHaveBeenCalledTimes(3);
+    });
+    it("respects Retry-After header on 429", async () => {
+        const mockPayload = { status: "success", data: { price: 80.0 } };
+        const mockFetch = vi
+            .fn()
+            .mockResolvedValueOnce({
+            ok: false,
+            status: 429,
+            statusText: "Too Many Requests",
+            headers: {
+                get: (name) => (name === "Retry-After" ? "5" : null),
+            },
+        })
+            .mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => mockPayload,
+            headers: { get: () => null },
+        });
+        const result = await runWithFakeTimers("/v1/prices/latest", mockFetch);
+        expect(result).toEqual(mockPayload);
+        expect(mockFetch).toHaveBeenCalledTimes(2);
+    });
+    it("returns null when all retries are exhausted on 500", async () => {
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: false,
+            status: 500,
+            statusText: "Internal Server Error",
+            headers: { get: () => null },
+        });
+        const result = await runWithFakeTimers("/v1/prices/latest", mockFetch);
+        expect(result).toBeNull();
+        expect(mockFetch).toHaveBeenCalledTimes(4);
+    });
+});
+// ---------------------------------------------------------------------------
+// COMMODITY_ALIASES and COMMODITY_INFO shape checks
+// ---------------------------------------------------------------------------
+describe("COMMODITY_ALIASES", () => {
+    it("has entries for major crude oil aliases", () => {
+        expect(COMMODITY_ALIASES["brent"]).toBe("BRENT_CRUDE_USD");
+        expect(COMMODITY_ALIASES["wti"]).toBe("WTI_USD");
+        expect(COMMODITY_ALIASES["urals"]).toBe("URALS_CRUDE_USD");
+        expect(COMMODITY_ALIASES["dubai"]).toBe("DUBAI_CRUDE_USD");
+    });
+    it("has entries for gas aliases", () => {
+        expect(COMMODITY_ALIASES["natural gas"]).toBe("NATURAL_GAS_USD");
+        expect(COMMODITY_ALIASES["ttf"]).toBe("DUTCH_TTF_EUR");
+        expect(COMMODITY_ALIASES["uk gas"]).toBe("NATURAL_GAS_GBP");
+    });
+    it("has entries for refined product aliases", () => {
+        expect(COMMODITY_ALIASES["diesel"]).toBe("DIESEL_USD");
+        expect(COMMODITY_ALIASES["gasoline"]).toBe("GASOLINE_USD");
+        expect(COMMODITY_ALIASES["jet fuel"]).toBe("JET_FUEL_USD");
+    });
+});
+describe("COMMODITY_INFO", () => {
+    it("provides name and unit for BRENT_CRUDE_USD", () => {
+        const info = COMMODITY_INFO["BRENT_CRUDE_USD"];
+        expect(info).toBeDefined();
+        expect(info.name).toBe("Brent Crude Oil");
+        expect(info.unit).toBe("barrel");
+    });
+    it("provides name and unit for DUTCH_TTF_EUR", () => {
+        const info = COMMODITY_INFO["DUTCH_TTF_EUR"];
+        expect(info).toBeDefined();
+        expect(info.name).toBe("European Natural Gas (TTF)");
+        expect(info.unit).toBe("MWh");
+    });
+    it("provides name and unit for EU_CARBON_EUR", () => {
+        const info = COMMODITY_INFO["EU_CARBON_EUR"];
+        expect(info).toBeDefined();
+        expect(info.name).toBe("EU Carbon Allowances");
+        expect(info.unit).toBe("metric ton CO2");
+    });
+    it("provides name and unit for GOLD_USD", () => {
+        const info = COMMODITY_INFO["GOLD_USD"];
+        expect(info).toBeDefined();
+        expect(info.name).toBe("Gold");
+        expect(info.unit).toBe("troy oz");
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -1,12 +1,51 @@
 #!/usr/bin/env node
 /**
- * OilPriceAPI MCP Server
+ * OilPriceAPI MCP Server v2.0.0
  *
- * Provides real-time oil, gas, and commodity prices through the Model Context Protocol.
- * For use with Claude Desktop, Claude Code, and other MCP-compatible clients.
+ * The energy commodity MCP server. Real-time oil, gas, and commodity prices
+ * for Claude, Cursor, VS Code, and any MCP-compatible client.
  *
  * @see https://oilpriceapi.com
  * @see https://modelcontextprotocol.io
  */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const USER_AGENT = "oilpriceapi-mcp/2.0.0";
+export declare const COMMODITY_ALIASES: Record<string, string>;
+export declare const COMMODITY_INFO: Record<string, {
+    name: string;
+    unit: string;
+}>;
+export declare const COMMODITY_CODES: readonly ["BRENT_CRUDE_USD", "WTI_USD", "URALS_CRUDE_USD", "DUBAI_CRUDE_USD", "NATURAL_GAS_USD", "NATURAL_GAS_GBP", "DUTCH_TTF_EUR", "COAL_USD", "NEWCASTLE_COAL_USD", "DIESEL_USD", "GASOLINE_USD", "GASOLINE_RBOB_USD", "JET_FUEL_USD", "HEATING_OIL_USD", "GOLD_USD", "GOLD_AM_USD", "GOLD_AM_GBP", "GOLD_AM_EUR", "GOLD_PM_USD", "GOLD_PM_GBP", "GOLD_PM_EUR", "SILVER_FIX_USD", "SILVER_FIX_GBP", "SILVER_FIX_EUR", "EU_CARBON_EUR", "EUR_USD", "GBP_USD"];
+interface PriceData {
+    code: string;
+    price: number;
+    currency: string;
+    created_at?: string;
+    updated_at?: string;
+    change_24h?: number;
+    change_24h_percent?: number;
+}
+export interface ApiResponse<T> {
+    status: string;
+    data: T;
+}
+/**
+ * Resolve a natural language commodity name to its API code.
+ * Returns null if no match found — callers should return an actionable error.
+ */
+export declare function resolveCommodityCode(input: string): string | null;
+/**
+ * Format a price for display
+ */
+export declare function formatPrice(data: PriceData): string;
+/**
+ * Make API request to OilPriceAPI with retry and exponential backoff
+ */
+export declare function makeApiRequest<T>(endpoint: string, fetchFn?: typeof fetch): Promise<T | null>;
+/**
+ * Resolve a US state name or abbreviation to a 2-letter code.
+ */
+export declare function resolveStateCode(input: string): string | null;
+export declare function createSandboxServer(): McpServer;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,eAAO,MAAM,UAAU,0BAA0B,CAAC;AASlD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6EpD,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4BzE,CAAC;AAGF,eAAO,MAAM,eAAe,icA4BlB,CAAC;AA6DX,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAuED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BjE;AAyED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA6BnD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA0DnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe7D;AA6+BD,wBAAgB,mBAAmB,cAElC"}