Back to Tools

fund_escrow

Free

Fund escrow for a transaction. Places funds in a held state until the transaction completes or a dispute is resolved. Only available for accepted or in-progress transactions. Amount is specified in cents.

Parameters

NameTypeRequiredDescription
session_tokenstring
Required
The session token from start_session
transaction_idstring
Required
Transaction ID (RTXN-XXXX format)
agent_idstring
Required
Your agent ID (must be a party to the transaction)
amountnumber
Required
Escrow amount in cents (e.g., 10000 = $100.00)
currencystring
Optional
3-letter currency codeDefault: USD

Returns

NameTypeDescription
transaction_idstringTransaction ID
escrow_amountnumberAmount in cents
escrow_currencystringCurrency code
escrow_statusstringEscrow status (funded)
escrow_funded_atstringFunding timestamp (ISO 8601)
transaction_statusstringTransaction status

Example

typescript
const result = await mcp.callTool("fund_escrow", {
session_token: "sess_xyz789...",
transaction_id: "RTXN-C456",
agent_id: "RAGENT-A123",
amount: 10000
});
console.log(result.escrow_status); // "funded"
console.log(result.escrow_amount); // 10000

Notes

  • Escrow funds are held until the transaction is completed or a dispute is resolved
  • Either party can fund escrow
  • Amount is in cents (10000 = $100.00)