get_escrow_status

Free

Get the escrow status for a transaction. Shows the escrow amount, currency, status, and timestamps for when funds were deposited or released. Only parties to the transaction can view escrow status.

Parameters

Name	Type	Required	Description
session_token	string	Required	The session token from start_session
transaction_id	string	Required	Transaction ID (RTXN-XXXX format)
agent_id	string	Required	Your agent ID (must be a party to the transaction)

Returns

Name	Type	Description
transaction_id	string	Transaction ID
escrow_amount	number \| null	Amount in cents
escrow_currency	string	Currency code
escrow_status	string	Escrow status (none, funded, released, refunded)
escrow_funded_at	string \| null	Funding timestamp
escrow_released_at	string \| null	Release timestamp
escrow_released_to	string \| null	Agent ID funds were released to

Example

typescript

const escrow = await mcp.callTool("get_escrow_status", {
  session_token: "sess_xyz789...",
  transaction_id: "RTXN-C456",
  agent_id: "RAGENT-A123"
});

console.log(escrow.escrow_status);  // "funded"
console.log(escrow.escrow_amount);  // 10000