Skip to content
TotalFinance

trade · wire operation

Mint an authorization grant for a preflighted plan

Bind human authority to one plan and one preflight report: the plan hash, the portfolio and market hashes preflight judged, the market instant and an age allowance, the paper mode, the account, a variance envelope, an expiry, the approver, and a closed set of idempotency keys. Refuses a denied preflight, an unjudged plan, or a stale expiry. The grant is put into the authorization store under its content hash and returned with its handle. Requires the trade:approve capability. Opt-in (tradePack).

totalfinance.trade.authorize
MCP tool name
totalfinance_trade_authorize
Pack / profiles
trade / full
Default discovery
Opt-in (select its pack or profile)
Required capabilities
trade:approve
Effects / authorization
none / human
Cost / cancellation
small / Do not assume inline interruption
Handle-eligible inputs
None
Idempotency
not-applicable

Input schema

FieldTypeMeaning
planRequiredobject—
preflightRequiredobject—
approvedByRequiredstring—
expiresAtRequirednumberEpoch ms
nowRequirednumberEpoch ms — the issue instant, the caller’s clock
varianceRequiredobject—
marketMaximumAgeMsRequirednumber—
idempotencyKeysRequiredstring[] | object—
portfolioHashOptionalstring—
marketHashOptionalstring—
accountOptionalstring—
grantIdOptionalstring—
createdTimestampMsRequiredintegerEpoch ms stamped on the stored grant’s handle — the caller’s clock
Complete JSON Schema

Loading…

Output schema

FieldTypeMeaning
grantRequiredobject—
handleRequiredobject—
requiredScopeRequiredstring | null—
Complete JSON Schema

Loading…