Skip to main content
Glama

Server Details

Live US diesel prices and optimized stop-by-stop fuel plans for trucking. Free snapshot tool.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
ChatGPT
–
Claude
ValveRide Flow

TDQS

A4.3/5.0

Scored across 4 tools

Disambiguation5/5

Each tool has a clearly distinct target: nearby station prices, a single station price by id, a cached market snapshot, and an optimized route plan. The two diesel-price tools are similar but their names and descriptions make the lookup mode unambiguous.

Naming Consistency3/5

All names use snake_case, but the patterns are mixed: diesel_prices_near and diesel_price_station are noun-oriented, fuel_market_snapshot is a noun phrase, and optimize_fuel_plan is verb_noun. The set remains readable, but it lacks a single predictable convention.

Tool Count5/5

Four tools are well scoped for the domain: price discovery, station detail, market context, and route planning. Each tool has a clear role and none feels redundant or missing from a minimal working set.

Completeness4/5

The surface covers the core workflows: checking nearby prices, looking up a specific station, getting market context, and building or replanning an optimized fuel plan. Minor gaps exist around retrieving plan history or browsing stations by brand/network, but agents can largely work around them.

Available Tools

4 tools
diesel_prices_nearFlow Diesel Prices: diesel prices near a pointAInspect

Flow Diesel Prices. Returns posted retail diesel prices at truck stops near a point, nearest first, from ValveRide Flow's price data. The result is { data: StationPrice[] }; stations with no price to offer are left out. Each StationPrice has station_id, source, brand, name, city, state, lat, lng, price (pump-posted retail diesel in US dollars per gallon, before any discount), confidence (0 to 1), estimated (true when the price is modeled from nearby observations rather than observed at the station) and observed_at. radius is in miles (default 10, max 50); limit defaults to 50 (max 100). On a ValveRide partner API key, send partner_tenant_ref (or the X-Partner-Tenant-Ref header) with every call; the lookup counts toward the key's plan. On a developer API key, partner_tenant_ref is not needed and the lookup counts toward the account's Flow Diesel Prices plan.

Inputs: lat (required), lon (required), limit, radius, +2 more.

diesel_price_stationFlow Diesel Prices: diesel price at a truck stopAInspect

Flow Diesel Prices. Returns the posted retail diesel price at one truck stop from ValveRide Flow's price data, by the stop's public station id (pf_ followed by 16 hex characters, as returned by diesel_prices_near). The result is { data: StationPrice }, or { data: null } when the station has no price to offer. Each StationPrice has station_id, source, brand, name, city, state, lat, lng, price (pump-posted retail diesel in US dollars per gallon, before any discount), confidence (0 to 1), estimated (true when the price is modeled from nearby observations rather than observed at the station) and observed_at. On a ValveRide partner API key, send partner_tenant_ref (or the X-Partner-Tenant-Ref header) with every call; the lookup counts toward the key's plan. On a developer API key, partner_tenant_ref is not needed and the lookup counts toward the account's Flow Diesel Prices plan.

Inputs: station_id (required), include_estimated, partner_tenant_ref.

fuel_market_snapshotUS diesel market snapshot (free)A
Read-onlyIdempotent
Inspect

Cached US diesel market snapshot from ValveRide Flow's retail price grid, refreshed every 12 hours. Returns national median/p10/p90 retail diesel and per-state percentiles for any states mentioned in origin/destination, plus typical optimized-savings context. Use this for market questions or cost estimates; use optimize_fuel_plan (Flow Fuel Plans) when you need an actual stop-by-stop plan, and the Flow Diesel Prices tools for posted prices at specific truck stops (available on ValveRide partner API keys only). This tool is free and carries no charge.

Inputs: origin, destination.

optimize_fuel_planFlow Fuel Plans: optimize a truck fuel planAInspect

Flow Fuel Plans. Build an optimized diesel fuel plan for a truck route. Send the truck profile, current fuel, origin, and destination; ValveRide Flow routes the leg, discovers truck stops along it, prices them from its live retail diesel grid, applies your discount schedule on net price, and returns where to stop, how many gallons to buy, and the estimated savings (IFTA tax-aware). The response includes a tripId; to replan mid-trip, call again with that tripId, currentLocation set to the truck's live position, and the updated currentFuelGallons. A replan of the same trip costs far less than a new plan: on a monthly Flow Fuel Plans tier every 10 replans count as 1 plan, and from the trial credit a new plan draws $2.25 and a replan of the same trip $0.08. Monthly tiers: Starter $99/month for 200 plans, Growth $349/month for 1,000 plans, Partner $799/month for 3,000 plans. VENDOR RULE: if the user restricts fueling to a brand or network ("Love's only", "we can only fuel at Pilot or Flying J"), you MUST set vendorRule.allowedVendors to those brands. It is a hard rule: only those stations are considered and, if none works, the tool returns no_feasible_plan_under_vendor_rule instead of an off-brand stop. Put any discount the user mentions for that brand in discountSchedule with the same vendor in the SAME call (for example "10 cents off at Love's" = vendorRule.allowedVendors ["Loves"] plus discountSchedule [{vendor:"Loves", discountType:"CENTS_PER_GALLON", discountAmount:10}]). The response echoes vendorRule and appliedDiscounts so you can confirm both were enforced.

Inputs: truck (required), origin (required), destination (required), currentFuelGallons (required), +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      AI-powered route optimization MCP server for heavy vehicles and logistics. Calculate truck-optimized routes, predict traffic congestion with LSTM neural networks, compute toll costs, fuel costs and CO2 emissions, find truck stops and check weather along any European route.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Quote, book, and track real LTL, FTL, cargo van, and box-truck freight through the Warp network - 20 tools, in-chat login, Stripe-charged bookings, and real carrier dispatch. Quoting is keyless; booking needs a free Warp account with a card on file.
      20
      363 npm
      8
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources