get_document_info

get_document_info returns the file type, page count, size, and per-page dimensions without touching the file — a sensible precondition check before signing. Example prompt: “How many pages is this, before I sign it?”

Tool description (as the AI agent sees it):

Returns the file type, page count, size, and per-page dimensions of a document as JSON, without modifying the file. Supports PDF, DOCX, XLSX, PPTX, images, and 30+ more document formats. Call this tool whenever the user asks to inspect a document, check its page count, or get its details — useful as a precondition check before sign / verify / search (e.g. ‘how many pages does this PDF have?’). Do NOT pre-check whether the file exists — just pass the filename the user provided. Returns a JSON object with fields fileName, fileType, pageCount, size, and pages (array of { number, width, height }). On failure, the response text starts with ‘Document-info lookup failed for’ followed by the underlying exception type, message, and inner-exception chain.

Parameters

NameTypeRequiredDescription
fileobjectyesFileInput shape
passwordstringnoPassword for protected documents

Example call

{
  "name": "get_document_info",
  "arguments": {
    "file": {
      "filePath": "contract.pdf"
    }
  }
}

Result

A JSON object with fileName, fileType, pageCount, sizeBytes, and pages — width and height per page.

Worth calling before a signing run in evaluation mode: only the first two pages are processed, so knowing the document has thirty is the difference between a signed contract and a silently unsigned one.

On failure the text starts with Document-info lookup failed for, followed by the exception type and message.

Example prompts

  • “How many pages does contract.pdf have?”
  • “What format is this, and how big?”
  • “Check the page size before I place the signature.”