Skip to content
MCP tools
Read-onlyDocumentsMCP tool

documents_list

List the documents attached to a specific entity (escrow, listing, client, lead, or appointment).

List the documents attached to a specific entity (escrow, listing, client, lead, or appointment). Returns each document id (pass it to documents_get_risks), filename, original_name, document_type, category, mime_type, file_size, requires_signature, signed_at, is_primary_contract, and created_at, newest first. Use this to see what is on file for a transaction (the RPA, TDS, NHD, pre-approval on an escrow). Read-only; returns only documents the agent can access under their tenant scope.

Parameters#

ParameterTypeRequiredDescription
entity_typeenumYesThe kind of record the documents are attached to. · One of: escrow, listing, client, lead, appointment
entity_idstringYesThe id of the escrow, listing, client, lead, or appointment. · Max length: 50 · Min length: 1
limitnumberNoMax documents to return (default 50). · Max: 200 · Min: 1

Example prompts#

  • "Show me my documents."

Safety#

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