Skip to content
MCP tools
View as Markdown
Updates dataCommission ledgerMCP tool

commission_ledger_update

Update mutable fields of a commission ledger entry — typically advancing status (pending → processing → paid), recording the actual payout date / check number, or correcting amounts.

Update mutable fields of a commission ledger entry — typically advancing status (pending → processing → paid), recording the actual payout date / check number, or correcting amounts. Use as payouts move through processing. Setting status to paid without an actual_payout_date stamps the current date automatically. Only entries the caller can see may be updated. Returns the updated ledger entry.

Parameters#

ParameterTypeRequiredDescription
idstringYesUUID of the commission ledger entry to update · Format: UUID
statusenumNoNew payment status · One of: pending, processing, paid, cancelled
sale_pricenumberNoCorrected sale price in dollars · Min: 0
commission_ratenumberNoCorrected commission rate (percent) · Min: 0
brokerage_splitnumberNoCorrected brokerage split percentage · Min: 0
gross_commissionnumberNoCorrected gross commission in dollars · Min: 0
agent_commissionnumberNoCorrected agent commission in dollars · Min: 0
net_commissionnumberNoCorrected net commission in dollars · Min: 0
referral_feenumberNoCorrected referral fee in dollars · Min: 0
transaction_feenumberNoCorrected transaction fee in dollars · Min: 0
projected_payout_datestringNoProjected payout date (YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
actual_payout_datestringNoActual payout date (YYYY-MM-DD) · Format: Date (YYYY-MM-DD)
check_numberstringNoCheck number for the payout
deposit_accountstringNoDeposit account the payout went to
notesstringNoFree-text notes about this commission

Example prompts#

  • "Update one of my commission ledger."

Safety#

Updates data. Changes an existing record. The change is visible immediately in the app and can be edited back.