documents module lists document metadata and supports opt-in company/coach writes to client document sections. File contents and document download URLs are not returned by list tools.
Available Tools
list_folders
List folders defined in the client’s file vault.
- Type: Read-only
- Important Input Fields:
clientId(string, optional): Filter by client ID.
list_documents
List documents and files uploaded by or for the client.
- Type: Read-only
- Important Input Fields:
clientId(string, optional): Filter by client ID.folderId(string, optional): Filter by folder directory.
Write tools
All four actions require the documents module, health consent, a non-read-only connection, the individual tool grant and normal write idempotency. Existing connections do not gain these permissions automatically. Use client IDs fromsearch_clients and folder IDs from list_folders.
Linking also accepts
folderId, mimeType and fileSize (a display string).
Preparing also accepts folderId and name. Uploads accept PDF, TXT, DOCX,
XLSX, JPEG and PNG up to 25 MiB, with matching file extension and MIME type.
Nested subfolders are not supported. Upload folders must belong to the client
and cannot be shared/default folders.
Binary transfer
Preparation returns a multipart/form-data POST valid for 15 minutes. An HTTP-capable client must send every returned field unchanged, followed by the binary file in a field namedfile, to upload.url. Never forward the FITsociety
Bearer token to the upload endpoint. Temporary fields authorize only this upload.
MCP itself does not accept file bytes or local file paths. If an assistant has no
binary HTTP transfer capability, it must explain that limitation and use an
external integration to perform this step.
Call completion after the file upload succeeds. Completion checks ownership,
folder access, expiry, actual byte count and declared MIME type.
Reusing an upload URL cannot replace a published file. These checks are not a
malware scan. A repeated completion returns the same document.
Neither preparation nor publication sends email or chat messages.
Each write needs its own idempotencyKey (or params._meta.idempotencyKey).
Reuse it only for the same request. A recorded failed completion needs a new key
once the cause is corrected; a replayed preparation does not renew its expiry.
See the Documents API guide for the equivalent HTTP flow.
get_document_download_link
Get a 5-minute download link for one document from list_documents. Open the link to read the file; request a new link when it expires.
- Type: Read
- Input Fields:
documentId(string, required)
Natural Language Examples
- “Check if client client_8821 has uploaded any medical release files.”
- “List folders in the document vault of client client_123.”