ARK TMS

MCP documentation | MCP docs for agents

ark_create_manual_load_bid

ark.create_manual_load_bid

Create or update a pending manual carrier bid for a visible ARK load after a broker collects it by phone or email.

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

Input

loadIdstringrequired

Visible ARK load ID for the manual bid.

format: uuid

carrierIdstring

Visible organization carrier ID that submitted the manual bid. Omit when tracking a bid from a carrier not in TMS; then provide carrierName plus dotNumber or mcNumber.

format: uuid

carrierNamestring | null

Carrier name when the bidding carrier is not onboarded in TMS.

max length: 200

dotNumberstring | null

DOT number for a carrier not in TMS. Required with mcNumber or alone.

max length: 50

mcNumberstring | null

MC/MX/FF docket number for a carrier not in TMS.

max length: 50

bidAmountnumberrequired

Carrier bid amount in the load carrier currency.

notesstring | null

Optional bid note or contact context.

max length: 1000

contactMethodstring

How the broker collected the manual bid.

one of: phone, email; default: "phone"

Result

The tool returns the canonical ark.create_manual_load_bid 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.