{"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":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":21,"wrote":0,"callsTried":1,"callsAnswered":1,"callContacts":[]},"history":[{"package":"document-mcp","version":"4.14.230","ranAt":"2026-11-16T11:32:26.028Z","outcome":"started","tools":21,"contacts":0,"flags":0,"serious":0,"toolsHash":"38949c9f4f5ce97fb78596f2c88ad05c0ba787af485eb0a362304bbfec9ff80a"},{"package":"document-mcp","version":"4.14.229","ranAt":"2026-11-12T17:52:33.026Z","outcome":"started","tools":21,"contacts":0,"flags":0,"serious":0,"toolsHash":"38949c9f4f5ce97fb78596f2c88ad05c0ba787af485eb0a362304bbfec9ff80a"}],"page":"https://bragproof.smaverk.com/r/document-mcp"}