ValveRide Flow
Server Details
Live US diesel prices and optimized stop-by-stop fuel plans for trucking. Free snapshot tool.
- 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
Scored across 4 tools
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.
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.
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.
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 toolsdiesel_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)ARead-onlyIdempotentInspect
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
Real-time fuel prices, alerts, and cheapest gas stations across 38+ countries.
Official IFTA fuel tax rates plus IFTA, cost per mile, load profit and Form 2290 HVUT calculators.
US gas and diesel prices by station, ZIP or city. Paid, on Apify's hosted MCP.
Road miles, drive times, stop order, truck miles by state (IFTA), tolls and truck restrictions.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides real-time freight tracking and load visibility for logistics and AI agents: create loads, get live GPS positions, trip stats, and confirm deliveries via geofenced statuses.1MIT
- AlicenseNot gradedqualityCmaintenanceAI-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
- AlicenseAqualityBmaintenanceEnables AI assistants to fetch current EIA weekly retail fuel averages by U.S. region, state, or city, compare surveyed locations, and estimate fill-up and trip costs with week-over-week, four-week, and year-ago changes.3MIT

warp-agent-mcpofficial
AlicenseAqualityCmaintenanceQuote, 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.20363 npm8MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.