MCP documentation | MCP docs for agents

ark_preview_factoring_activity

ark.preview_factoring_activity

Preview factoring activity against the current assignment, agreement, balances, evidence, and preparation fingerprint without creating a command or ledger entry.

Availability
Expanded preview
Scopes
loads:readbilling:read
ARK permissions
canViewLoadscanViewBilling
Team visibility
Required and enforced
Approval policy
none
ARK approval request
Not required
Idempotency
Not required
Read-only
Yes
Destructive
No
External side effect
No
Rate limit
OAuth MCP credential and organization budgets

Input

obligationIdstringrequired

format: uuid

preparationFingerprintstringrequired
kindstringrequired

one of: funding, customer_collection, reserve_release, fee, mixed

effectiveDatestringrequired
referencestring | null
advanceMinorstringrequired
grossCollectionMinorstringrequired
reserveHoldMinorstringrequired
reserveReleaseMinorstringrequired
feeMinorstringrequired
feeSourcestring | nullrequired
varianceAcknowledgedboolean

default: false

varianceNotestring | null

Result

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