MCP documentation | MCP docs for agents

ark_send_load_location_notification

ark.send_load_location_notification

Send a manual location-update notification for a visible ARK load using configured tracking notification recipients and throttle rules.

Availability
Expanded preview
Scopes
loads:write
ARK permissions
one of: canEditLoadone of: canAssignLoads
Team visibility
Required and enforced
Approval policy
ask_before_send
ARK approval request
Required before execution
Idempotency
Required for external execution
Read-only
No
Destructive
No
External side effect
Yes
Rate limit
OAuth MCP credential and organization budgets

Input

loadIdstringrequired

Visible ARK load ID whose recipients should receive a location update.

format: uuid

citystringrequired

City for the manually reported location.

min length: 1; max length: 200

statestringrequired

State or province for the manually reported location.

min length: 1; max length: 20

countrystring

one of: USA, CAN, MEX; default: "USA"

latitudenumber | null

min: -90; max: 90

longitudenumber | null

min: -180; max: 180

timezoneIdstring | null

IANA timezone ID for the location timestamp, when known.

max length: 100

locationDateTimestring

ISO timestamp for the manually reported location. Defaults to now.

format: date-time

Result

The tool returns the canonical ark.send_load_location_notification operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.