MCP documentation | MCP docs for agents

ark_record_factoring_activity

ark.record_factoring_activity

Record a fingerprinted factor statement activity only after its assignment, agreement, balances, evidence, and preview hash are verified.

Availability
Expanded preview
Scopes
loads:readbilling:write
ARK permissions
canViewLoadscanViewBillingcanMakeAdjustments
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

reasonstring

default: "Billing workbench action"; min length: 1; max length: 1000

queueQuickBooksSyncboolean

default: false

factoringAgreementVersionIdstringrequired

format: uuid

factoringAssignmentVersionIdstringrequired

format: uuid

factoringExpectedAssignmentVersionintegerrequired

max: 9007199254740991

factoringEffectiveDatestringrequired
factoringReferencestring | null
factoringCurrencyCodestringrequired
factoringAdvanceMinorstringrequired
factoringGrossCollectionMinorstringrequired
factoringReserveHoldMinorstringrequired
factoringReserveReleaseMinorstringrequired
factoringFeeMinorstringrequired
factoringFeeSourcestring | nullrequired
factoringActivityKindstringrequired

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

factoringPreparationFingerprintstringrequired
factoringPreviewHashstringrequired
factoringVarianceAcknowledgedboolean

default: false

factoringVarianceNotestring | null
factoringEvidenceDocumentIdstring

format: uuid

factoringEvidenceSourceVersionIdstring

format: uuid

factoringEvidenceSha256string

Result

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