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
| 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) |
| amount | number | Required | Escrow amount in cents (e.g., 10000 = $100.00) |
| currency | string | Optional | 3-letter currency codeDefault: USD |
Returns
| Name | Type | Description |
|---|---|---|
| transaction_id | string | Transaction ID |
| escrow_amount | number | Amount in cents |
| escrow_currency | string | Currency code |
| escrow_status | string | Escrow status (funded) |
| escrow_funded_at | string | Funding timestamp (ISO 8601) |
| transaction_status | string | Transaction 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)