Gas Price News Search by Keyword and Date Range (First 10 Matches)

omnial/gas-price-news-search-by-date-range

Given a keyword or phrase and a start and end date, returns up to 10 gas price news reports published in that range that match it: each report's title, publication date and time, a plain-text excerpt, its article ID and its URL slug, plus the total number of matching reports.

activeper callv1

Price

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

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

AAA Gas Prices

Data from AAA Gas Prices.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

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

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/gas-price-news-search-by-date-range" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/gas-price-news-search-by-date-range" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/gas-price-news-search-by-date-range", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/gas-price-news-search-by-date-range", 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 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "query",
    "start_date",
    "end_date"
  ],
  "properties": {
    "page": {
      "enum": [
        1
      ],
      "type": "integer",
      "default": 1,
      "description": "Results page: 1, the first page of matches. The only value offered."
    },
    "limit": {
      "enum": [
        10
      ],
      "type": "integer",
      "default": 10,
      "description": "Reports returned: up to 10. The only value offered."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The keyword or phrase to search report titles and text for, such as a holiday, a state or an event."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Latest publication date to include, as YYYY-MM-DD (inclusive)."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Earliest publication date to include, as YYYY-MM-DD (inclusive)."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "articles": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "The report's article ID."
              },
              "date": {
                "type": "string",
                "description": "Publication date and time, as YYYY-MM-DDTHH:MM:SS."
              },
              "slug": {
                "type": "string",
                "description": "The report's URL slug."
              },
              "title": {
                "type": "string",
                "description": "The report's title."
              },
              "excerpt": {
                "type": "string",
                "description": "The report's opening text as plain text, cut short."
              }
            }
          },
          "description": "Up to 10 matching reports."
        },
        "total_posts": {
          "type": "number",
          "description": "How many reports in the date range match the query."
        }
      }
    }
  },
  "description": "The matching news reports, as returned after shaping."
}