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
loadIdstringrequiredVisible ARK load ID whose recipients should receive a location update.
format: uuid
citystringrequiredCity for the manually reported location.
min length: 1; max length: 200
statestringrequiredState or province for the manually reported location.
min length: 1; max length: 20
countrystringone of: USA, CAN, MEX; default: "USA"
latitudenumber | nullmin: -90; max: 90
longitudenumber | nullmin: -180; max: 180
timezoneIdstring | nullIANA timezone ID for the location timestamp, when known.
max length: 100
locationDateTimestringISO 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.