Get EIA facet option values
eia_get_facet_optionsGet valid facet option IDs for an EIA dataset to use as filter values in data queries. Retrieve available codes for a specified facet, such as state or sector, to build accurate facet filters.
Instructions
List the valid option values (ids) for one facet of a dataset.
Returns {"route", "facet_id", "total", "options": [...]}. Use the
returned ids as values in the facets argument of eia_get_data, e.g.
facets={"stateid": ["CA", "NY"]}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"route": "<route>",
"facet_id": "<facet_id>"
},
"name": "eia_get_facet_options"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| route | Yes | Leaf dataset route, e.g. 'electricity/retail-sales'. | |
| facet_id | Yes | Facet id whose values to list, e.g. 'stateid' or 'sectorid'. Discover facet ids with eia_list_facets. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||