# ValveRide Flow - Developer and Integration Documentation

Diesel fuel optimization software for trucking fleets: an optimized fuel plan for every dispatch in under two seconds using the fleet's own negotiated contracts, delivered to the driver over ELD, SMS, email, API, ChatGPT, or Claude, and continuously re-planned for the whole trip as the route, prices, and truck position change. A product of ValveRide, LLC.

Proof points: about $0.90 per gallon in reconciled savings, blended across live fleets, trailing 12 months (not a per-fleet guarantee; each fleet's result depends on its lanes, contracts, and current fueling habits, and is measured against that fleet's own transactions); under 2 seconds from dispatch to optimized fuel plan; 7,500+ US truck stops priced, refreshed multiple times per day; 48 states with data.

## Ways to integrate

1. **TMS/ELD webhook (fleets):** your dispatch system posts a load to your Flow webhook URL; an optimized fuel plan comes back in the response in under 2 seconds and appears in your portal. Works with McLeod, TMW, Alvys, Magnus; direct ELD integrations: Isaac, Samsara, Omnitracs, Motive, Thermo King, ORBCOMM. Credentials (tenant slug, webhook secret, API key) are issued at onboarding and rotatable from the portal.
2. **Engine API (partners/developers):** POST https://app.valverideflow.com/api/v1/engine/optimize with a truck profile, position, destination, and your discount schedule. OpenAPI spec: https://valverideflow.com/openapi.json
3. **MCP server (AI agents):** https://app.valverideflow.com/api/mcp (Streamable HTTP, JSON-RPC 2.0). Tools:
   - `fuel_market_snapshot` - FREE: cached US diesel market snapshot (national and per-state percentiles), no card required.
   - `optimize_fuel_plan` - metered: a full optimized plan ($2.25/plan, $0.08/replan of the same trip, prepaid credits, $20 free credit at signup).
   Auth: developer API key (Bearer vrf_dev_...) or OAuth 2.0 (discovery: https://app.valverideflow.com/.well-known/oauth-authorization-server).

## Quickstart (under 5 minutes)

1. Get a free developer key at https://app.valverideflow.com/developers (email sign-in, $20 free credit).
2. List the tools:
   curl -X POST https://app.valverideflow.com/api/mcp -H "content-type: application/json" -H "Authorization: Bearer vrf_dev_YOURKEY" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
3. Get a real plan:
   curl -X POST https://app.valverideflow.com/api/mcp -H "content-type: application/json" -H "Authorization: Bearer vrf_dev_YOURKEY" -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"optimize_fuel_plan","arguments":{"truck":{"tankCapacityGallons":240,"mpgForPlanning":6.5},"currentFuelGallons":80,"origin":"Dallas, TX","destination":"Memphis, TN"}}}'
   The response includes stops, gallons, net prices, estimated savings, and a tripId for $0.08 replans.

Flow is available as an app in ChatGPT (https://chatgpt.com/plugins/plugin_asdk_app_6a7220b2e21081919348e9f9334473ba) and as a connector in Claude (https://claude.ai/directory/connectors/app-valverideflow-com). In Claude: Settings > Connectors > Browse, search ValveRide Flow, Connect.

Or connect the MCP server directly in Claude Code, Cursor, or any MCP client: endpoint https://app.valverideflow.com/api/mcp, OAuth or bearer key.

Setup for Claude, ChatGPT and your own app, with pricing: Flow by MCP (https://valverideflow.com/mcp).

## Pricing

- Solo: $25 per truck per month (Owner-operators and small fleets, no truck limit)
- Growth: $40 per truck per month (Self-serve fleets, month-to-month)
- Enterprise: from $49 per truck per month (Medium and large fleets)
- Developer API: $2.25 per plan, $0.08 per replan, prepaid credits, $20 free credit.
- Flow Inside partner pricing (volume): about 2 cents per in-network gallon - https://valverideflow.com/flow-inside

## Data

- Live US diesel prices by state: https://valverideflow.com/diesel-prices (public JSON: https://app.valverideflow.com/api/v1/public/diesel-prices, CC BY 4.0)
- Free fuel plan tool: https://valverideflow.com/fuel-plan

Contact: https://valverideflow.com/contact