Gas Price Change by State (Day/Week/Month/Year)

omnial/get-price-change-by-state

One call returns how much gas prices have moved in a given US state, broken down by fuel grade (Regular, Mid-Grade, Premium, Diesel) and by time window (day, week, month, year). Positive numbers mean prices rose over that window; negative numbers mean they fell.

activeper callv2

Price

Up to $0.0273 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-price-change-by-state" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/get-price-change-by-state", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/get-price-change-by-state", 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.0273

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": {
        "state_code": {
          "type": "string",
          "description": "The two-letter state code echoed back, e.g. 'TX'."
        },
        "state_name": {
          "type": "string",
          "description": "The full state name, e.g. 'Texas'."
        },
        "price_changes": {
          "type": "object",
          "properties": {
            "Diesel": {
              "type": "object",
              "properties": {
                "day_change": {
                  "type": "number",
                  "description": "Change over the last day, e.g. 0.018."
                },
                "week_change": {
                  "type": "number",
                  "description": "Change over the last week, e.g. 0.31."
                },
                "year_change": {
                  "type": "number",
                  "description": "Change over the last year, e.g. 2.769."
                },
                "month_change": {
                  "type": "number",
                  "description": "Change over the last month, e.g. 0.912."
                }
              },
              "additionalProperties": true
            },
            "Premium": {
              "type": "object",
              "properties": {
                "day_change": {
                  "type": "number",
                  "description": "Change over the last day, e.g. 0.02."
                },
                "week_change": {
                  "type": "number",
                  "description": "Change over the last week, e.g. 0.098."
                },
                "year_change": {
                  "type": "number",
                  "description": "Change over the last year, e.g. 1.212."
                },
                "month_change": {
                  "type": "number",
                  "description": "Change over the last month, e.g. 0.338."
                }
              },
              "additionalProperties": true
            },
            "Regular": {
              "type": "object",
              "properties": {
                "day_change": {
                  "type": "number",
                  "description": "Change over the last day, e.g. 0.018."
                },
                "week_change": {
                  "type": "number",
                  "description": "Change over the last week, e.g. 0.106."
                },
                "year_change": {
                  "type": "number",
                  "description": "Change over the last year, e.g. 1.171."
                },
                "month_change": {
                  "type": "number",
                  "description": "Change over the last month, e.g. 0.333."
                }
              },
              "additionalProperties": true
            },
            "Mid-Grade": {
              "type": "object",
              "properties": {
                "day_change": {
                  "type": "number",
                  "description": "Change over the last day, e.g. 0.019."
                },
                "week_change": {
                  "type": "number",
                  "description": "Change over the last week, e.g. 0.099."
                },
                "year_change": {
                  "type": "number",
                  "description": "Change over the last year, e.g. 1.193."
                },
                "month_change": {
                  "type": "number",
                  "description": "Change over the last month, e.g. 0.332."
                }
              },
              "additionalProperties": true
            }
          },
          "description": "One entry per fuel grade, typically: 'Regular', 'Mid-Grade', 'Premium', 'Diesel'. Each carries the same four numeric change fields, in USD/gallon -- positive means prices rose over that window, negative means they fell.",
          "additionalProperties": true
        }
      },
      "description": "Present only when state_code matched a real US state; absent for an invalid state code.",
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' when the state is found; absent for an invalid state code."
    }
  },
  "description": "The price-change result. On an invalid two-letter state code the result is an entirely empty object -- no `status` or `data` field at all -- so no field here is required.",
  "additionalProperties": true
}