The Tools of folio-assistant-sci, in the two forms other tools read:

  • openapi.json — OpenAPI 3.1.0, one operation per Tool. Open it in Swagger UI or Redoc, or generate a client from it. The paths are the Tools’ call contracts, not HTTP endpoints: each operation’s x-invoke says how the Tool is really reached.
  • mcp-tools.json — the answer an MCP server gives to tools/list: each tool’s name, description and input schema, read from the registrar that serves it.

Operations (26)

operationsummaryrequestresponsereached as
POST /tools/check-dependenciesDependency proberequired_only?: Flagreport?: MarkdowninProcess, mcp, shell
POST /tools/content-manifest-validateContent manifest validationtargetPath?: RepoPath, strict?: Flagissues?: Textshell
POST /tools/headless-render-qcHeadless render QC (Playwright)screenshot?: Flagreport?: Textshell
POST /tools/latex-imageCompile LaTeX in a containermainTex: RepoPathpdf?: RepoPathcontainer
POST /tools/latex-overfullLaTeX overfull-box reportlog: RepoPath, min?: Dpi, max?: Dpi, json?: Flagreport?: Textshell
POST /tools/latex-preflightLaTeX preflightjson?: Flag, warn?: Flagfindings?: Textshell
POST /tools/latexmk-compileLaTeX compilation (latexmk)tex: RepoPath, args?: Textpdf?: RepoPathshell
POST /tools/lean-auditLean vacuity auditchapter?: Slug, strict?: Flag, checkAxioms?: Flag, json?: Flagfindings?: Textshell
POST /tools/lean-buildLean buildpaper?: Slug, cache?: Flag, update?: Flag, logDir?: RepoPathstatus?: RepoPathshell
POST /tools/lean-cacheLake olean cacheaction: LakeCacheAction, lakeRoot?: RepoPath, package?: PackageNameresult?: Textshell
POST /tools/lean-coverageLean coveragepaper?: Slug, contentRoot?: RepoPath, json?: Flag, out?: RepoPathcoverage?: Textshell
POST /tools/lean-formal-edgesFormal edges from the Lean buildlake_dir: RepoPath, root?: RepoPath, ingest?: Flagreport?: MarkdowninProcess, mcp
POST /tools/lean-html-docsBuild a Lean package’s HTML docs (doc-gen4)lakeRoot: RepoPath, lib: InstanceId, platform?: RepoPath, restore?: Flag, allowCold?: Flag, dryRun?: Flagrender?: RepoPathshell
POST /tools/lean-kg-publishPublish the dynamic Lean viewer: doc-gen4 declaration data as knowledge-graph shardsdocData: RepoPath, site: RepoPath, route?: Slug, module?: PackageName, contentRoot?: RepoPath, repo?: RepoFullName, ref?: Branch, contentPrefix?: RepoPath, base?: Url, externalBase?: Url, homeLabel?: InstanceId, instance?: InstanceId, platform?: RepoPath, noRail?: Flagviewer?: RepoPathshell
POST /tools/lean-render-publishPublish a Lean render under a folio site, with the harness raildocs: RepoPath, site: RepoPath, route?: Slug, module?: PackageName, externalBase?: Url, homeLabel?: InstanceId, instance?: InstanceId, platform?: RepoPath, noRail?: Flagpages?: RepoPathshell
POST /tools/lean-toolchain-setupLean toolchain install—toolchain?: Textshell
POST /tools/paper-feature-buildPaper feature build (changed chapters + latexdiff)base?: Branch, chapters?: Slug, paper?: Slug, out?: RepoPath, notation?: RepoPath, preload?: RepoPathpreview?: RepoPathshell
POST /tools/paper-latex-buildPaper build to LaTeX chapterspaperManifest?: RepoPath, outDir?: RepoPathchapters?: RepoPathshell
POST /tools/paper-preferencesRendering preferencesaction?: PreferenceAction, render_format?: RenderFormat, render_scope?: RenderScope, latex_engine?: LatexEngine, math_renderer?: MathRenderer, auto_preview?: Flag, formula_dpi?: Dpi, default_chapter?: RepoPath, print_mode?: PrintMode, compact_inline_refs?: Flagpreferences?: MarkdowninProcess, mcp
POST /tools/paper-previewOpen a renderfile?: RepoPath, format?: PreviewFormat, list?: Flagopened?: MarkdowninProcess, mcp
POST /tools/proof-dependency-graphProof dependency graphmanifest?: RepoPath, output?: RepoPath, pdfBaseUrl?: Url, dotOnly?: Flaggraph?: RepoPathshell
POST /tools/proof-objects-extractProof-object extractionoutput?: RepoPathmanifest?: RepoPathshell
POST /tools/proof-status-updateProof status from a Lean buildmanifest?: RepoPath, buildLog?: RepoPathmanifest?: RepoPathshell
POST /tools/tex-installInstall TeX Live in a sandbox—engine?: Textshell
POST /tools/tex-snippet-validateTeX snippet validation (AST)paper?: Slug, file?: RepoPath, compile?: Flag, json?: Flag, warningsLog?: RepoPathreport?: Textshell
POST /tools/tex-source-auditTeX-source hazard auditstrict?: Flagreport?: Textshell

MCP tools (4)

MCP tooldescriptionparametersToolread from
check_dependenciesCheck all required and optional dependencies for the paper writing assistant. Reports what’s installed, what’s missing, and install hints.required_only?: booleancheck-dependenciesregistrar
lean_formal_edgesExtract ELABORATED formal dependencies between a folio’s lean.ref declarations (LeanArchitect’s rule over the folio’s own lean.ref set; no attributes, no LeanArchitect). Needs a Lean toolchain and a …lake_dir: string, root?: string, ingest?: booleanlean-formal-edgesregistrar
paper_preferencesGet or set user rendering preferences. Preferences persist across sessions in .folio-prefs.json. Set action=’get’ to view current, ‘set’ to update, ‘reset’ to restore defaults.action?: string, render_format?: string, render_scope?: string, latex_engine?: string, math_renderer?: string, auto_preview?: boolean, formula_dpi?: number, default_chapter?: string, print_mode?: string, compact_inline_refs?: booleanpaper-preferencesregistrar
paper_previewOpen a rendered PDF or HTML file in the system browser. Lists available renders if no specific file is given.file?: string, format?: string, list?: booleanpaper-previewregistrar

folio-assistant — code under the Apache License 2.0, documentation under CC BY 3.0. Generated schema and API references are rebuilt from source on every push to main.

deployed dev