read_metadata

read_metadata reads the metadata properties of a document — author, title, creation date, custom properties, and format-specific sets such as EXIF and XMP — and returns them as JSON. Example prompt: “Who is the author of report.pdf, and when was it created?”

Tool description (as the AI agent sees it):

Reads all metadata properties from a document (author, title, creation date, custom properties) and returns them as JSON. Call this tool immediately whenever the user asks to read metadata, show document properties, or get author/title/date info. Do NOT pre-check whether files exist — just pass the filename the user provided. The tool resolves files from storage and returns an error with available files if a name is not found.

Parameters

NameTypeRequiredDescription
fileobjectyesFileInput shape
passwordstringnoPassword for protected documents

Example call

{
  "name": "read_metadata",
  "arguments": {
    "file": {
      "filePath": "report.pdf"
    }
  }
}

Result

A JSON object of properties grouped by the metadata packages present in the file.

Use this when the whole picture matters — a privacy review, an audit, a “what is in this file” question. When you only want one property, search_metadata returns less and reads better.

In evaluation mode this result is truncated to the first five document properties without saying so. Confirm the licence before drawing conclusions from an empty-looking file.

On failure the text starts with Metadata read failed for, followed by the exception type and message.

Example prompts

  • “What metadata does report.pdf carry?”
  • “Who created this document and when?”
  • “Show me the EXIF data from this photo.”
  • “List the custom properties on this spreadsheet.”

See it used end-to-end: Audit document metadata.