US State Gas Price Details (by State Code)

omnial/get-state-price-details

Given a two-letter US state code, returns that state's current average price per gallon for Regular, Mid-Grade, Premium, and Diesel, plus the same averages from yesterday, a week ago, a month ago, and a year ago, and the all-time highest recorded price on file with its date.

activeper callv2

Price

Up to $0.0137 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Data source

AAA Gas Prices

Data from AAA Gas Prices.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/get-state-price-details" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/get-state-price-details" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/get-state-price-details", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/get-state-price-details", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0137

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "state_code"
  ],
  "properties": {
    "state_code": {
      "type": "string",
      "description": "Two-letter US state code (e.g. TX, CA, NY, FL). All 50 states and DC are supported."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "prices": {
          "type": "object",
          "properties": {
            "Diesel": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "Premium": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "Regular": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "Mid-Grade": {
              "type": "object",
              "properties": {
                "current": {
                  "type": "number"
                },
                "week_ago": {
                  "type": "number"
                },
                "year_ago": {
                  "type": "number"
                },
                "month_ago": {
                  "type": "number"
                },
                "yesterday": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            }
          },
          "description": "Average price per gallon by fuel grade. Observed keys: 'Regular', 'Mid-Grade', 'Premium', 'Diesel' -- the vendor's endpoint description states this covers all fuel grades, and all four appear (e.g. for Texas).",
          "additionalProperties": true
        },
        "state_code": {
          "type": "string",
          "description": "Echoes the requested code, e.g. 'TX'."
        },
        "state_name": {
          "type": "string",
          "description": "Full state name, e.g. 'Texas'."
        },
        "highest_recorded": {
          "type": "object",
          "properties": {
            "Diesel": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "e.g. '9/9/26' (M/D/YY)."
                },
                "price": {
                  "type": "string",
                  "description": "Numeric string, e.g. '5.5368'."
                }
              },
              "additionalProperties": true
            },
            "Regular Unleaded": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "e.g. '6/15/22' (M/D/YY)."
                },
                "price": {
                  "type": "string",
                  "description": "Numeric string, e.g. '4.6949'."
                }
              },
              "additionalProperties": true
            }
          },
          "description": "All-time highest recorded price on file, per fuel grade, with the date it was recorded. Only 'Regular Unleaded' and 'Diesel' were present for Texas, for example -- note this grade naming does NOT match `prices`' own grade keys ('Regular Unleaded' here vs. 'Regular' above), and whether 'Mid-Grade' /'Premium' entries ever appear here for other states is unconfirmed. `price` is a numeric string here (e.g. '4.6949'), unlike the plain numbers under `prices`.",
          "additionalProperties": true
        }
      },
      "description": "Absent entirely for an unrecognized state_code (e.g. 'ZZ', observed) -- that case returns output: null, shaping down to an empty object rather than an error. Present with the fields below only for a recognized two-letter state code.",
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on the real populated call observed (a valid state code)."
    }
  },
  "description": "The state price record.",
  "additionalProperties": true
}