register a Virtual End Node (VEN) and subscribe to reports from a Virtual Top Node (VTN) using the OpenADR 3.0/3.1 REST API
domain: openadr.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Obtain OAuth2 client credentials from the VTN operator and perform the client_credentials token grant
Register the VEN via the /vens endpoint and associate it with one or more /resources representing physical assets it controls
Create /reportDescriptions and subscribe via /subscriptions, specifying which object operations (e.g. new /events) trigger a callback
Poll or receive webhook callbacks for new /events matching an enrolled /programs, and POST an updated event status
Periodically GET /reports to retrieve and submit usage/telemetry data tied to the VEN's resources
Renew the OAuth2 token before expiry to keep the subscription and reporting flow active
Known gotchas
OpenADR 3.1.0 (released 2025) extends 3.0 with additional fields; confirm which minor version the VTN implements since the spec has continued to evolve
Subscriptions require a reachable callback URL for push notifications — VENs behind NAT/firewalls typically must fall back to polling /events instead
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?