{"report":"{\"v\":1,\"package\":\"document-mcp\",\"version\":\"4.14.230\",\"ranAt\":\"2026-11-16T11:32:26.028Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-qZsmp/bWv7bT2Us53Mpz085ThyTZbfWKiB1Bm5qhvJH3C7tOgVcAV1KnUVCSh0LagIZCd1UaSOGlcLa1QtDgRQ==\",\"deps\":35,\"scripts\":[],\"bins\":[\"document-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=20\",\"repository\":\"git+https://github.com/ExaDev/documents.js.git\",\"bin\":\"document-mcp\"},\"start\":{\"ok\":true,\"ms\":835,\"serverName\":\"document-mcp\",\"serverVersion\":\"4.14.230\",\"protocol\":\"2025-06-18\"},\"tools\":[{\"name\":\"compute_formula\",\"description\":\"Reads every formula a document embeds (docx/odt/markdown paragraphs and pptx/odp slide shapes; a table cell's own blocks too — docx's own reader recovers a real equation nested inside a table cell; structurally, the walk also covers a drawing page's own shape flow, though no writer in the family populates a formula there today; a spreadsheet's own cell-anchored formula objects; a standalone .odf formula document; and a formula nested inside another embedded object at any depth, e.g. a formula embedded in a drawing embedded in a spreadsheet) and evaluates each through document-compute.js's units-typed evaluate() — a caller's way to check whether a document's stated arithmetic actually checks out. A formula referencing a symbol (e.g. F = m * a) needs that symbol's value supplied via bindings, keyed by the document's own symbol-table id (see the document's symbolTable.symbols[].id, or a returned formula's own latex to identify which symbol is which); a formula with no free symbols (units and numeric literals only) evaluates with no bindings at all. Each formula reports its own outcome independently — 'evaluated' with the result, 'no-content' when the formula was never lowered to a computable MathExpression (the common case for a spreadsheet's own embedded formula object, or any format other than markdown, none of which yet stores the semantic layer on disk), or 'error' naming which document-compute.js error it hit (e.g. UnboundSymbolError) — so one formula needing more bindings never blocks the others. Each entry's own `locate` field is the reliable way to tell two formulas in the same document apart — a structural path guaranteed unique per formula — unlike `sourcePath`, which several formats leave undefined or stamp with the identical constant across sibling formulas (markdown's own display-math lowering among them).\",\"params\":[\"source\",\"bindings\"]},{\"name\":\"convert_document\",\"description\":\"Converts a document from one supported format to another via documents.js's DocumentConverter port — docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, rtf, wpd, doc, xls, ppt, epub, csv, svg, and pdf. Not every (source, targetFormat) pair is supported directly (odf, for instance, only ever converts to pdf); call list_document_conversions first to see which pairs actually are.\",\"params\":[\"source\",\"targetFormat\",\"output\",\"fonts\",\"onSubstitutionDiagnostics\",\"images\"]},{\"name\":\"list_document_conversions\",\"description\":\"Lists every (source, target) format pair convert_document actually supports, straight from documents.js's own DocumentConverter port — the definitive source of truth for what convert_document will and will not accept as a (source, targetFormat) combination.\",\"params\":[]},{\"name\":\"docx_extras\",\"description\":\"Reads a docx's own comments, footnotes, header/footer parts, and numbering definitions — data documents.js's ContentDocument pivot cannot carry, so ordinary document-reading operations never see it. Returns the real DocxExtras object (comments/footnotes/headerFooterParts/sectionHeaderFooters/numbering) as structured data.\",\"params\":[\"source\"]},{\"name\":\"document_create\",\"description\":\"Creates a fresh, blank document in the given format via documents.js's own live-view editors (createDocx/createOdt/createMarkdownEditor/...), the same construction document_append_paragraphs's own edit calls build on. Returns an empty document with no content — follow with document_append_paragraphs (docx/odt/markdown) to add text.\",\"params\":[\"format\",\"output\"]},{\"name\":\"document_append_paragraphs\",\"description\":\"Appends one or more paragraphs — each optionally built from several independently-formatted runs — to the end of a docx, odt, or markdown document, through documents.js's own live-view editors (the same DocxBody.appendParagraph/OdtBody.appendParagraph/MarkdownBody.appendParagraph document-cli's own TUI uses). Does not convert format — the source document's own format and targetFormat must match. docx and odt share an identical field set (underline, fontFamily, sizePt, colorHex, headingLevel, alignment all supported); markdown supports a different, smaller set (hyperlink, code) and rejects the docx/odt-only fields outright rather than silently dropping them. This covers wordprocessing paragraph/run editing only — slides, sheets, drawings, tables, lists, and images are a separate, larger editing surface not exposed here yet.\",\"params\":[\"source\",\"targetFormat\",\"paragraphs\",\"output\"]},{\"name\":\"fonts\",\"description\":\"Lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length).\",\"params\":[\"source\"]},{\"name\":\"describe_font_file\",\"description\":\"Reads a standalone TrueType/OpenType font file (.ttf/.otf) and reports the family/bold/italic triple it declares about itself.\",\"params\":[\"source\"]},{\"name\":\"from_package\",\"description\":\"Rebuilds real document bytes in a target format from a DocumentTree previously serialised to JSON (e.g. by a caller's own --dump-package-equivalent step) — the read side of the DocumentTree round trip a conversion's onDocument callback produces.\",\"params\":[\"source\",\"targetFormat\",\"output\"]},{\"name\":\"metadata_read\",\"description\":\"Reads a document's own title/author/subject/keywords/creator/producer/created-and-modified-timestamp metadata. Works across every supported format, including xlsx (read via a throwaway xlsx-to-pdf preview, since documents.js has no dedicated xlsx metadata reader of its own) and odf (a standalone formula document).\",\"params\":[\"source\"]},{\"name\":\"metadata_write\",\"description\":\"Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format — the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion operation) if metadata needs to be set on the result of a format change.\",\"params\":[\"source\",\"targetFormat\",\"output\",\"setTitle\",\"setAuthor\",\"setSubject\",\"setKeywords\"]},{\"name\":\"odb_tables\",\"description\":\"Lists every table an embedded .odb database declares — column names, types, and row data — across every storage tier documents.js supports (HSQLDB TEXT/CACHED/BINARY script formats, Firebird gbak backups).\",\"params\":[\"source\"]},{\"name\":\"odb_forms\",\"description\":\"Lists every form an .odb database declares, with each form's own data source and field-bound controls.\",\"params\":[\"source\"]},{\"name\":\"odb_reports\",\"description\":\"Lists every report an .odb database declares, with each report's own data-source command, band/group structure, and rpt: formula expressions.\",\"params\":[\"source\"]},{\"name\":\"odb_query\",\"description\":\"Runs a bounded SELECT (with optional JOINs of any kind, table aliases, a derived table in FROM, and IN/EXISTS subqueries) over an embedded .odb database's own extracted tables, given directly as SQL or by naming one of the database's saved queries. No database engine is involved — the query runs in memory over the same tables odb_tables would return, against a closed grammar (SELECT/FROM/JOIN [INNER|LEFT [OUTER]|RIGHT [OUTER]|FULL [OUTER]|CROSS|NATURAL] ... [ON|USING]/WHERE/GROUP BY/ORDER BY, with an optional [AS] alias on any table, WHERE and ON also accepting [NOT] IN (SELECT ...) and [NOT] EXISTS (SELECT ...) — no column aliases); an unsupported construct is reported as an error naming it, never silently ignored.\",\"params\":[\"source\",\"sql\",\"query\"]},{\"name\":\"odb_to_csv\",\"description\":\"Extracts exactly one named table from an embedded .odb database as CSV bytes. The table name is required whenever the database declares more than one table.\",\"params\":[\"source\",\"table\",\"output\"]},{\"name\":\"odb_to_xlsx\",\"description\":\"Extracts every table an embedded .odb database declares into one xlsx workbook, one sheet per table.\",\"params\":[\"source\",\"output\"]},{\"name\":\"odb_render_report\",\"description\":\"Resolves one of an .odb database's own reports — its data-bound command run through the bounded SQL engine, its rpt: formulas evaluated, its bands laid out — and renders the result to docx, odt, or pdf.\",\"params\":[\"source\",\"report\",\"targetFormat\",\"output\",\"fonts\"]},{\"name\":\"odm_to_pdf\",\"description\":\"Converts a .odm (ODF master document) to PDF. A .odm never carries its own chapters' content inline — every text:section is a bare external reference to a standalone .odt file — so each chapter the master document declares must resolve through `chapters` (an explicit href -> document override) and/or `chaptersDir` (a directory searched by the href's own basename), checked in that order. A chapter left unresolved by both fails the whole conversion, naming every unresolved href.\",\"params\":[\"source\",\"chapters\",\"chaptersDir\",\"output\"]},{\"name\":\"outline_document\",\"description\":\"Projects a document's table of contents as a structured outline: reads the source's own native DocumentTree directly (documents.js's readNativeDocumentTree — no bridging conversion, no discarded output bytes) and runs document-outline.js's buildOutline over it. Groups carry { text, level, children } (a heading's, list item's, slide's, sheet's, or page's own label plus nested children); leaves carry { kind, text }.\",\"params\":[\"source\"]},{\"name\":\"pdf_inspect\",\"description\":\"Parses a PDF (documents.js's readPdf) and reports a summary: page count, each page's own size and item-kind histogram, document metadata, and embedded image formats. Pass full: true to return the entire parsed LayoutDocument instead of a summary.\",\"params\":[\"source\",\"full\"]}],\"toolsHash\":\"38949c9f4f5ce97fb78596f2c88ad05c0ba787af485eb0a362304bbfec9ff80a\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:32:33.852Z\",\"calls\":[{\"tool\":\"list_document_conversions\",\"ok\":true,\"ms\":5,\"bytes\":8129}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0Ojk0ZWRiZGE1NWIzZjdmMzljNjNlMGU5M2I2NzAwMzZiMTVjODA1YjhjMDgyNmZkZGEzM2E3NzBhMGE3ZDZkY2QiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTUxMyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTA1OSwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjg3NTksImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiZDU1ZjdmNDYtNWQ1YS00Y2VhLTk4ZDQtOWMwMmI2NGIxOGU2IiwibmJmIjoxNzk0ODI4NDU5LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.qoQwK6aq5S-CMx5wzhA9qW7Ckrto4Ne-rG2m8YiD4-bTcesEqAzK2e3ZkVvaFWLxWKKJGbJ0tS9kS2t0Rz3uAn1l3eoZCTIpY2YXArjB2RxC-987-6VbUmXv5Mr9efY1GMexl6w7DJeu6A2DdlVfn-e8hViu9JeUrswShIc3ibe2eZcDrh3kdw_bVXPpeQvf2LE4dQnkq0aHKwRspl1E5YE5WN1itwonKc5OPk-MBI4eMA7a7QZaGFY4A_NcytXD4_k3-M4X7UG3rS5afFQ3WUNNs2s4CodsOkk_evNLINLQpKKx-i_47_szO9RxCK9lIeul2y6GZeQR1AF88A_Zbg"}