`eia_ethanol`

Pack: eia · Endpoint: https://gateway.pipeworx.io/eia/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/eia_ethanol for the schema, then POST the same URL with its arguments for the data.

Get fuel ethanol production volumes, stocks, and imports. Returns time series for ethanol supply chain metrics.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	EIA API key
`series`	string	yes	Ethanol data type: “production”, “stocks”, “imports”
`frequency`	string	no	Frequency: “weekly”, “monthly” (optional, defaults to weekly)
`start`	string	no	Start date (optional)
`end`	string	no	End date (optional)

Example call

Arguments

{
  "_apiKey": "your-eia-api-key",
  "series": "production"
}

curl

curl -X POST https://gateway.pipeworx.io/eia/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"eia_ethanol","arguments":{"_apiKey":"your-eia-api-key","series":"production"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('eia_ethanol', {
  "_apiKey": "your-eia-api-key",
  "series": "production"
});

More examples

{
  "_apiKey": "your-eia-api-key",
  "series": "stocks",
  "frequency": "weekly",
  "start": "2024-01-01"
}

Response shape

Always returns: series, total, description, count, data, truncated

Field	Type	Description
`series`	string	Ethanol series type with ‘ethanol_’ prefix
`total`	number	Total number of records available
`description`	string \| null	Series description from EIA API
`count`	number	Number of records returned
`data`	array	Time series data points (max 100 returned)
`truncated`	boolean	True if more than 100 records available

Full JSON Schema

{
  "type": "object",
  "properties": {
    "series": {
      "type": "string",
      "description": "Ethanol series type with 'ethanol_' prefix"
    },
    "total": {
      "type": "number",
      "description": "Total number of records available"
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Series description from EIA API"
    },
    "count": {
      "type": "number",
      "description": "Number of records returned"
    },
    "data": {
      "type": "array",
      "description": "Time series data points (max 100 returned)",
      "items": {
        "type": "object",
        "properties": {
          "period": {
            "type": [
              "string",
              "null"
            ],
            "description": "Time period (e.g., date or year)"
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "description": "Numeric value for the period"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Series description"
          },
          "area": {
            "type": [
              "string",
              "null"
            ],
            "description": "Geographic area name"
          },
          "product": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product type"
          },
          "process": {
            "type": [
              "string",
              "null"
            ],
            "description": "Process or measurement type"
          },
          "units": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unit of measurement"
          }
        }
      }
    },
    "truncated": {
      "type": "boolean",
      "description": "True if more than 100 records available"
    }
  },
  "required": [
    "series",
    "total",
    "description",
    "count",
    "data",
    "truncated"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "eia": {
      "url": "https://gateway.pipeworx.io/eia/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

eia_ethanol