gas-prices-today-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Average retail gas and diesel prices per gallon, read at call time from the U.S. Energy Information Administration (EIA) weekly survey (published Mondays). A model cannot know this week's price. Use get_gas_prices for "gas prices today" or "price of gas in ", compare_gas_prices for the cheapest and most expensive places, and cite EIA. These are averages, not station prices.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_gas_pricesA | Latest EIA weekly average retail price per gallon (taxes included) of regular, midgrade or premium gasoline, all grades or diesel for the US, an EIA region, one of nine surveyed states, one of ten surveyed cities, or the region of any other state, read at call time from eia.gov: price, change from last week and four weeks ago, the price a year ago, the last six survey weeks and the next release date. |
| compare_gas_pricesA | Ranks the areas EIA prices (states, cities, regions) from cheapest to most expensive for a grade this week, with the US average, the cheapest and the most expensive area. |
| estimate_fill_up_costA | Cost of filling a tank (gallons times this week's EIA average for the area, or your price per gallon), and optionally the fuel cost of a trip from miles and miles per gallon, including cents per mile. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool has a clearly distinct job: get_gas_prices fetches a single area/grade reading, compare_gas_prices ranks many areas against each other, and estimate_fill_up_cost performs a cost calculation. There is no overlap in intent, and the descriptions make the boundaries explicit (e.g., ranking vs. single lookup).
All three names follow a consistent snake_case verb_noun pattern (get_, compare_, estimate_ + domain object). The verbs are distinct but stylistically uniform, so the convention is predictable.
Three tools is a well-scoped surface for a focused gas-price data server: retrieve, compare, and apply to a cost estimate. Each tool earns its place with no filler or redundancy.
The read-only domain is well covered: current price with weekly/yearly deltas and history, cross-area ranking, and downstream cost math. The one minor gap is there is no way to enumerate valid area names (nine surveyed states, ten cities, regions), so an agent must guess accepted inputs.