{"openapi":"3.0.3","info":{"title":"Gnist Context — Commodity Prices","description":"Real-time and historical commodity prices — oil, gas, gold, silver, copper, wheat, and 20+ more.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/commodity-prices/`\n- **Toolkit page:** `/toolkits/commodity-prices`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/commodity-prices/get_commodity_price":{"post":{"tags":["Economics"],"summary":"get_commodity_price","description":"Get price data for a commodity.\n\nReturns historical price observations from FRED for the specified commodity.\nCovers energy (oil, gas), precious metals (gold, silver, platinum),\nindustrial metals (copper, aluminum, nickel), agricultural products\n(wheat, corn, coffee, cocoa), livestock, and forestry.\n\nCommon commodities:\n- crude-oil-wti — WTI Crude Oil (daily, USD/barrel)\n- crude-oil-brent — Brent Crude Oil (daily, USD/barrel)\n- natural-gas — Henry Hub Natural Gas (daily, USD/MMBtu)\n- gold — Gold London PM Fix (daily, USD/troy oz)\n- silver — Silver London Fix (daily, USD/troy oz)\n- copper — Copper (monthly, USD/metric ton)\n- wheat — Wheat (monthly, USD/metric ton)\n- corn — Corn/Maize (monthly, USD/metric ton)\n- coffee — Coffee Arabica (monthly, USD/kg)","operationId":"commodity_prices_get_commodity_price","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"commodity":{"description":"Commodity slug. Examples: \"gold\", \"crude-oil-wti\", \"crude-oil-brent\", \"natural-gas\", \"silver\", \"copper\", \"wheat\", \"corn\", \"coffee\". Use list_commodities to see all available options.","type":"string"},"observation_start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date (YYYY-MM-DD). Omit to fetch from series start."},"observation_end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End date (YYYY-MM-DD). Omit to fetch to latest available."},"frequency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Aggregate to lower frequency: \"d\" (daily), \"w\" (weekly), \"m\" (monthly), \"q\" (quarterly), \"a\" (annual)."},"limit":{"default":100,"description":"Maximum observations to return (default 100, max 100000).","type":"integer"}},"required":["commodity"],"type":"object"}}}}}},"/rest/commodity-prices/list_commodities":{"post":{"tags":["Economics"],"summary":"list_commodities","description":"List all available commodities.\n\nReturns the full catalog of commodities with their names, units,\ncategories, and underlying FRED series IDs. Use this to discover\nvalid commodity slugs for get_commodity_price.","operationId":"commodity_prices_list_commodities","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by category: \"energy\", \"precious-metals\", \"industrial-metals\", \"agricultural\", \"livestock\", \"forestry\". Omit for all."}},"type":"object"}}}}}},"/rest/commodity-prices/list_commodity_categories":{"post":{"tags":["Economics"],"summary":"list_commodity_categories","description":"List commodity categories with counts.\n\nReturns the available categories (energy, precious-metals,\nindustrial-metals, agricultural, livestock, forestry) and how\nmany commodities each contains.","operationId":"commodity_prices_list_commodity_categories","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/commodity-prices/compare_commodity_prices":{"post":{"tags":["Economics"],"summary":"compare_commodity_prices","description":"Compare prices for multiple commodities aligned on a common time axis.\n\nFetches price data for all specified commodities and aligns observations\nby date — only dates where all commodities have values are included.\nUseful for correlation analysis and cross-commodity comparisons.\n\nExample: compare_commodity_prices([\"crude-oil-wti\", \"natural-gas\"], frequency=\"m\")","operationId":"commodity_prices_compare_commodity_prices","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"commodities":{"description":"List of 2-10 commodity slugs to compare (e.g. [\"gold\", \"silver\"]).","items":{"type":"string"},"type":"array"},"observation_start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Start date (YYYY-MM-DD) applied to all commodities."},"observation_end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"End date (YYYY-MM-DD) applied to all commodities."},"frequency":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Aggregate to common frequency before aligning: \"m\" (monthly), \"q\" (quarterly), \"a\" (annual)."}},"required":["commodities"],"type":"object"}}}}}},"/rest/commodity-prices/report_feedback":{"post":{"tags":["Economics"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"commodity_prices_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Economics","description":"Data sources: Economics"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}