Upload a File and Let an Agent Read It

Create a files collection, upload a PDF, and have an agent find and read it over MCP. The agent gets the file's visible text and a verdict, never the original.

Prerequisites:


1. Create the files collection

Files belong to a parent record, so one customer's files stay with that customer.

  1. Open the owner collection, for example customers.
  2. In Subcollections, choose New subcollection.
  3. Choose Files, then Next.
  4. Name it documents, keep Enable strict reference hierarchy on, and choose Create Collection.

2. Upload a file

Open a record, go to its Files tab, choose Upload files and pick the PDF. It moves through Uploading and Processing to one of:

StateMeaning
ReadyAgents can read it.
In reviewA finding held it for a reviewer. See Policy.
RejectedBlocked or refused, with the reason.
FailedProcessing failed.

Open the file to see its findings. Without table analysis, a 5-page PDF costs 6 file units: 5 pages and a verdict. See Billing & Usage.


3. Let an agent read it

Add the collection to your Flux API (how), connect your MCP client, and ask something the document answers: "What is the total on the Acme invoice?" The agent will:

  1. find the collection with discover_resources;
  2. find the matching pages with search_records;
  3. read the record with get_record, adding include_links for page images.

The text arrives marked as untrusted, with the verdict and findings. The original is available only to people, through the dashboard or the Management API.


Next steps

Was this page helpful?