List Tank Utility devices and pull the latest tank level reading
domain: apidocs.tankutility.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate and obtain a token via getToken as described in the auth flow.
Call the devices endpoint with the token in the request header to list all devices assigned to your account.
Note the device ID(s) returned in the device list response.
Call the device-specific endpoint for a given device ID to retrieve its current data.
Read the lastReading object in the response for tank (percentage), temperature, time, and time_iso fields.
Treat a 410 response as an indication the tank was permanently removed from Tank Utility's servers.
Known gotchas
tank in lastReading is a percentage of capacity, not gallons — multiply by the device's capacity field to estimate gallons remaining.
There is no documented rate limit beyond a generic 429 'too many requests' error code — build in retry/backoff handling.
404 means the device ID doesn't exist; 403 means it exists but isn't linked to your account — the two are easy to conflate.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?