Read-onlyEscrowsMCP tool

`escrows_list`

Search for escrows.

Search for escrows. Returns IDs only by default for efficiency.

Response includes relatedIds with BOTH clientIds and contactIds:

relatedIds.clientIds: CLIENT table IDs → use with clients_bulk_update
relatedIds.contactIds: CONTACT table IDs → use with contacts_get (contact_ids)

WORKFLOW: To mark clients as closed when escrow closes:
1. escrows_list({ status: 'closed' }) → get relatedIds.clientIds
2. clients_bulk_update({ client_ids: relatedIds.clientIds, updates: { status: 'closed' } })

Direct workflow - no intermediate clients_list step needed!

Parameters#

Parameter	Type	Required	Description
`query`	string	No	Search term (searches property address, escrow number)
`status`	enum	No	Filter by escrow status (default: all) · One of: `all`, `active`, `pending`, `closed`, `cancelled`, `fell_through`
`fields`	array of enum	No	Field groups to include. Empty/omitted = IDs only (most efficient). Options: basic (id, display_id, address, status), dates (closing_date, etc), financial (price, commission), clients (buyers/sellers), location (city, state), property (beds, baths), full (all fields). · Values: `basic`, `dates`, `financial`, `clients`, `location`, `property`, `full`
`limit`	string or number	No	Max results. Use a number (e.g. "25") or "all". "all" and any value above 200 are capped at 200 server-side. · Max: 200
`offset`	number	No	Skip N records for pagination. Use pagination.nextOffset from previous response.
`slim`	boolean	No	DEPRECATED: Use fields parameter instead. slim=true maps to fields=[] (IDs only).

Example prompts#

"Which of my escrows are still active right now?"
"Find the escrow for 412 Birchwood Ln and show its closing date and price."

Safety#

Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.

Previous name#

This tool was previously published as search_escrows. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.