The Tools of every layer, 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 (219)

operation summary request response reached as
POST /tools/agent-memory Agent memory assembler — memory?: RepoPath shell
POST /tools/archimate-actors Check that an ArchiMate model’s fhir-actor tags point at the IG’s FHIR ActorDefinitions instance: RepoPath, model: ArchimateModelId, ig?: RepoPath, strict?: Flag, json?: Flag report?: Text shell
POST /tools/archimate-blocks Draw a document’s tables and figures from its ArchiMate data, and check the model against the document’s relationship rules instance: RepoPath, check?: Flag, strict?: Flag blocks?: RepoPath shell
POST /tools/archimate-check Check a layer’s ArchiMate models against its config instance: RepoPath problems?: Text shell
POST /tools/archimate-crossings Count the tangles in ArchiMate views: lines crossing lines, and lines through boxes model: RepoPath, view?: Slug, max?: Count, json?: Flag tangles?: Text shell
POST /tools/archimate-detangle Lower the tangles in ArchiMate views: re-route lines and swap same-size boxes in a row model: RepoPath, view?: Slug, routes-only?: Flag, apply?: Flag, json?: Flag report?: Text shell
POST /tools/archimate-from-glossary ArchiMate model from the glossary instance: RepoPath, model?: ArchimateModelId, write?: Flag, prune?: Flag, seed?: Flag, from?: RepoPath, check?: Flag model?: RepoPath shell
POST /tools/archimate-metamodel Derive the metamodel an ArchiMate model uses, and check it against ArchiMate’s relationship table instance: RepoPath, model?: ArchimateModelId, format?: ArchimateMetamodelFormat, check?: Flag metamodel?: Text shell
POST /tools/archimate-pages Give every ArchiMate view, element and relationship a page and an IRI, and draw every view instance: RepoPath, out?: RepoPath, check?: Flag pages?: Count shell
POST /tools/auto-docs-viewer Generated index pages check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/avatars-css Avatar stylesheet check?: Flag stylesheet?: RepoPath shell
POST /tools/bean-claim-check Check a bean is free, then claim it on every copy id: BeanId, copy?: RepoPath, repo?: RepoFullName, minePr?: Url, as?: Slug, session?: Url, agents?: RepoPath, window?: TimeWindow, dryRun?: Flag, json?: Flag check?: Markdown, result?: BeanClaimCheck inProcess, shell
POST /tools/bean-query Query the beans knowledge graph named?: Text, sparql?: Text, format?: Text report?: Markdown, result?: BeanQueryRows inProcess, mcp
POST /tools/beans-cli beans CLI id?: BeanId, status?: BeanStatus, body?: Markdown bean?: BeanId shell
POST /tools/beans-manual beans, by hand id?: BeanId, status?: BeanStatus, body?: Markdown bean?: BeanId manual, shell
POST /tools/bibliography-page Bibliography page check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/block-actions Block edit and feedback links repo?: RepoPath, block?: NodeId, github?: RepoFullName, edit-branch?: Branch, issue-template?: RepoPath links?: RepoPath shell
POST /tools/bpmn-checklist BPMN checklist projection out?: RepoPath, check?: Flag checklists?: RepoPath shell
POST /tools/bpmn-engine BPMN workflow engine process: ProcessId, node?: NodeId enabled?: NodeId inProcess, mcp
POST /tools/bpmn-render BPMN diagram rendering check?: Flag diagrams?: RepoPath shell
POST /tools/build-instance-site Build, check and (on request) publish a layer’s own site, or a branches/ preview root?: RepoPath, instance: Slug, home?: RepoPath, pre?: ScriptName, sourceStep?: ScriptName, siteStep?: ScriptName, staging?: Branch, noMount?: Flag, publish?: Flag, remote?: Url site?: RepoPath, links?: Count shell
POST /tools/c-value-terms Rank candidate glossary terms in prose by C-value files: RepoPath, maxLength?: Count, minFreq?: Count, top?: Count, edgeStopwords?: Flag, json?: Flag candidates?: Text shell
POST /tools/cat-harness-schema Layer declaration schema baseUrl?: Url schema?: RepoPath shell
POST /tools/catalogue-from-references Catalogue a library from its bibliography instance: RepoPath, apply?: Flag, check?: Flag, json?: Flag, baseUrl?: Url catalogue?: RepoPath shell
POST /tools/check-dsa-hash Verify Data Sharing Agreement hash, citation, and vocabulary terms dir?: RepoPath verdict?: Text shell
POST /tools/check-tools Do the Tool nodes agree with their skills? — report?: Text shell
POST /tools/ci-agent-review Run the agent review repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-bootstrap-pages Publish bootstrap-tools’ site repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-code-quality-gates Run the platform index’s code-quality gates repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-docs-site Build and publish the platform docs site repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-feature-staging Build and publish a branch preview repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-health Is CI passing on the default branch? markdown?: Flag, warn?: Flag, out?: RepoPath report?: Markdown shell
POST /tools/ci-iris-cdn Run the IRIS CDN export repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-iris-cover-pdfs Fetch IRIS cover PDFs repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-merge-main Merge main into opted-in PRs repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-merge-train Run the merge train repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-post-merge-regen Regenerate derived files after a merge repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-pr-checks Run a layer’s PR checks repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-pr-tests Run the tools layer’s own test suite repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-publish-context Publish a layer’s JSON-LD context repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-publish-subgraph-index Publish a layer’s sub-graph index package repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-repin-train Run the re-pin train repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-staging-publish Publish staged previews repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-standing-repin Run a layer’s standing re-pin repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/ci-sweeps Run the 15-minute sweeps repo?: RepoFullName, ref?: Branch run?: Text shell
POST /tools/compose-docs Compose the site’s documentation tree from its declared docs layers out: RepoPath, staging?: Flag, changed-files?: RepoPath, shell?: Flag files?: Count shell
POST /tools/content-context Content JSON-LD context check?: Flag context?: RepoPath shell
POST /tools/content-graph-analysis Editorial content-graph analysis paper?: Slug, chapter?: Slug, json?: Flag, md?: Flag, visualise?: Flag, proposals?: Flag report?: Text shell
POST /tools/content-graph-build Content graph targetPath?: RepoPath, json?: Flag report?: Text shell
POST /tools/content-graph-uml A paper’s block graph as UML root: RepoPath, out: RepoPath, status?: RepoPath, check?: Flag diagrams?: RepoPath shell
POST /tools/context-prefixes JSON-LD content-key check json?: Flag report?: Text shell
POST /tools/corpus-search Search the corpus and follow the graph query: Text, hops?: Count, direction?: Slug, provenance?: Slug, searchText?: Flag, limit?: Count result?: Markdown inProcess, mcp
POST /tools/declaration-resolution Every path a declaration names resolves — directories, assets, visualisers, needs root?: RepoPath, json?: Flag findings?: Count shell
POST /tools/diig-phases-svg DIIG phases, steps and resources chart figure-or-adaptation: RepoPath, out?: RepoPath svg?: RepoPath shell
POST /tools/discuss discussion question: Text, askedOf: Text answer?: Text manual
POST /tools/document-kinds-viewer Document kinds viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/drain-queue Build a bean drain queue copy?: RepoPath, holdings?: RepoPath, agents?: RepoPath, window?: TimeWindow, json?: Flag queue?: Markdown, result?: DrainQueue inProcess, shell
POST /tools/dublin-core-render Dublin Core renderings instance: RepoPath, check?: Flag renderings?: RepoPath shell
POST /tools/external-schemas-viewer External schemas viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/feature-staging Stage a branch’s preview branch?: Branch, cleanup_slug?: Slug, cleanup_confirm?: Slug preview?: Url shell
POST /tools/figure-coverage Figure coverage and computability entry: RepoPath, folio: RepoPath, exclusions?: RepoPath, out?: RepoPath report?: RepoPath shell
POST /tools/folio-block-qa-summary Folio block QA summary folio: RepoPath, out: RepoPath, repo?: RepoPath block-qa?: RepoPath shell
POST /tools/folio-block-screenshots Folio block screenshots changeset: RepoPath, base?: RepoPath, head?: RepoPath, out?: RepoPath, count?: Flag visual-diff?: RepoPath shell
POST /tools/folio-changeset Folio ChangeSet folio: RepoPath, base?: Branch, head?: Branch, out?: RepoPath, text-out?: RepoPath changeset?: RepoPath shell
POST /tools/folio-init Scaffold a folio title: Text, authors: Text, content_type?: ContentType, slug?: Slug, dir?: FilesystemPath, link?: LinkMode, assistant_path?: FilesystemPath, force?: Flag, dry_run?: Flag report?: Markdown inProcess, mcp, shell
POST /tools/folio-review-comment-move Move a review comment’s status id: NodeId, to: NodeId, process: ProcessId, task: NodeId, decision?: NodeId, todos?: RepoPath, published?: RepoPath, commit?: Flag, base?: Branch comment?: RepoPath shell
POST /tools/folio-review-comments Folio review comments repo: RepoFullName, pr: ChangeProposalNumber, out: RepoPath, folio?: RepoPath, blocks-out?: RepoPath, blocks?: RepoPath, existing?: RepoPath, commit?: CommitSha, todos?: RepoPath, comments?: RepoPath review-comments?: RepoPath shell
POST /tools/folio-review-coverage Folio review coverage changeset: RepoPath, blocks: RepoPath, comments: RepoPath, out?: RepoPath, todos?: RepoPath, commit?: Flag, base?: Branch coverage?: RepoPath shell
POST /tools/folio-viewer Folio viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/gates The platform’s quality gates all?: Flag, list?: Flag report?: Text shell
POST /tools/gates-merged Gates on the merged tree base?: Branch report?: Text shell
POST /tools/get-graph-stats Content graph counts refresh?: Flag stats?: Markdown inProcess, mcp
POST /tools/get-neighbors Walk the content graph from one node id: Text, direction?: Slug, hops?: Count, edges?: Text result?: Markdown inProcess, mcp
POST /tools/gh-pages GitHub Pages (gh-pages) root: RepoPath, url?: Url, subgraph?: Slug, sha?: CommitSha status?: Text, message?: Text manual
POST /tools/github GitHub (issues, Actions, pull requests) repo?: RepoFullName url?: Url manual, shell
POST /tools/glossary-build Glossary build targetPath: RepoPath, check?: Flag glossary?: RepoPath shell
POST /tools/glossary-from-source Glossary candidates from a source out: RepoPath, id?: Slug, title?: Text, from?: RepoPath, terms?: RepoPath, abbreviations?: RepoPath, check?: Flag scheme?: RepoPath shell
POST /tools/glossary-page Glossary page check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/glossary-table Glossary and acronyms tables instance: RepoPath, check?: Flag blocks?: RepoPath shell
POST /tools/handover-screen Screen a hand-over for injected instructions, field by field schema?: RepoPath, payload?: RepoPath, text?: RepoPath verdict?: Flag shell
POST /tools/harness-state Per-harness setup position and health out?: RepoPath, json?: Flag states?: RepoPath, report?: Text, result?: HarnessStates shell
POST /tools/ig-folio-site-workflow Build and publish an IG repository’s own site with its folio-site.yml workflow repo?: RepoFullName, ref?: Branch status?: Text shell
POST /tools/index-config-migrate Convert a checkout to a root index.config.json root?: RepoPath, write?: Flag, check?: Flag findings?: Count shell
POST /tools/ingest-extended Ingest, with PDF and image extensions file: RepoPath, outdir?: RepoPath, dryRun?: Flag slug?: Slug shell
POST /tools/ingest-stdlib Ingest, standard library only file: RepoPath, outdir?: RepoPath, dryRun?: Flag slug?: Slug shell
POST /tools/instantiate-harness Instantiate a harness over a repository that has none: pin, mount, open the setup-only PR, render the preview repo?: RepoPath, harness: RepoFullName, consentBy: Login, evidence?: Text, branch?: Branch, plan?: Flag, local?: Flag, noPr?: Flag url?: Url shell
POST /tools/iris-pages who-iris catalogue and docs pages check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/journey-refs Every reference a journey or a workshop names resolves root?: RepoPath, json?: Flag findings?: Count shell
POST /tools/journeys-viewer Journeys viewer instance: RepoPath, site?: RepoPath pages?: RepoPath shell
POST /tools/judge-tree Judge a tree and record the verdict by digest lock: RepoPath, caller: RepoFullName, caller-dir?: RepoPath, sha?: CommitSha, root?: RepoPath, instance?: InstanceId, base-verdict?: RepoPath, base-root?: RepoPath, test-path?: RepoPath, publish?: Flag record?: RepoPath shell
POST /tools/kg-audit Knowledge-graph audit check?: Flag, strict?: Flag sidecars?: RepoPath, worstSeverity?: Text shell
POST /tools/kg-graph-export Knowledge-graph export baseUrl?: Url, out?: RepoPath graph?: RepoPath, problems?: Text shell
POST /tools/kg-retrieve-npm Retrieve a remote Knowledge Graph via npm package or tarball package: Text, destination?: RepoPath, view?: Slug, release?: RepoPath status?: Text, summary?: Text shell
POST /tools/kg-validate Validate a node in the graph path: RepoPath, lenient?: Flag report?: Text shell
POST /tools/kg-viewer Knowledge graph viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/l1-complete-check L1 source completeness targetPath?: RepoPath report?: Text shell
POST /tools/l1-coverage L1 extraction coverage text: RepoPath, captured: RepoPath, exclusions?: RepoPath, out?: RepoPath report?: RepoPath shell
POST /tools/library-viewer Library viewer check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/log-message Log a message to the discussion timestamp: Timestamp, actor: Text, process: ProcessId, task: NodeId, message: Text, body?: Markdown entry?: Markdown manual
POST /tools/lsi-index Build the Latent Semantic Indexing index of a prose graph instance?: Slug, graph?: Slug index?: RepoPath shell
POST /tools/lsi-query Latent Semantic Indexing over a prose graph text: Text, instance?: Slug, graph?: Slug report?: Markdown inProcess, mcp, shell
POST /tools/lsi-viewer Indexing evidence viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/memory-checkpoint Keep where the work stands note: Markdown, shared?: Flag kept?: Text inProcess, mcp
POST /tools/memory-note Keep a note on the work note: Markdown, shared?: Flag kept?: Text inProcess, mcp
POST /tools/memory-recall Read what was kept shared?: Flag entries?: Markdown inProcess, mcp
POST /tools/merge-guard Judge whether a pull request may land pr: Count, repo?: RepoFullName, merge?: Flag, status?: Flag, full_tier?: Flag verdict?: Markdown shell
POST /tools/merge-leftover Merge leftover (has a PR’s intent landed?) member: Branch, base?: Branch report?: Text shell
POST /tools/merge-overlap Merge overlap (conflict prediction) base?: Branch, branches?: Branch report?: Text shell
POST /tools/merge-train Merge train base: CommitSha, branch?: Branch, dry-run?: Flag, no-main?: Flag, members: Branch report?: Text shell
POST /tools/mesh-authority Validate draft MeSH headings against NLM’s authority draft: RepoPath, json?: Flag report?: Text shell
POST /tools/methodologies-viewer Methodologies viewer check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/mount-from-lock Replay a committed mount lock with nothing but Node root?: RepoPath, check?: Flag outcomes?: Count shell
POST /tools/narrative-queue What narratives are waiting on a person — queue?: Text shell
POST /tools/navbar-include Write the site sidebar’s harness navbar include check?: Flag, instance?: Slug, link-root?: RepoPath, title?: Slug, out?: RepoPath include?: RepoPath shell
POST /tools/node-kind-pages Node kind pages check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/node-view-coverage Does every node have an IRI, a .jsonld, a page and a row? site?: RepoPath, base?: Url, check?: Flag, against?: Branch report?: RepoPath shell
POST /tools/npm Package manager and registry client for npm and GitHub Packages args?: Text stdout?: Text shell
POST /tools/ns-vocabulary Namespace vocabulary layer?: NamespaceLayer, out?: RepoPath vocabulary?: RepoPath shell
POST /tools/open-work-lookup Does a path or bean exist on main or any open PR path?: RepoPath, prefix?: RepoPath, bean?: BeanId, repo?: RepoFullName, json?: Flag lookup?: Markdown, result?: OpenWorkLookup inProcess, shell
POST /tools/openapi-ingest-rendered OpenAPI ingest from a published spec instance: RepoPath, only?: Slug documents?: RepoPath shell
POST /tools/openapi-ingest-source OpenAPI ingest from source instance: RepoPath, source: RepoPath, ref?: Branch documents?: RepoPath shell
POST /tools/openapi-pages OpenAPI viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/pack-tarball Package layer into an npm tarball and record binary release root?: RepoPath, destination?: RepoPath, out?: RepoPath, repository?: RepoFullName, release-url?: Url, json?: Flag release?: RepoPath, tarball?: RepoPath shell
POST /tools/package-exports A package’s exports are its declared, shipped code directories root?: RepoPath, write?: Flag findings?: Count shell
POST /tools/package-release-manual Package release by hand package: PackageName, repo?: RepoFullName tag?: Text manual
POST /tools/package-release-workflow Release package via GitHub Actions release workflow package?: PackageName, version: Text, repo?: RepoFullName, workflow?: Text tag?: Text, status?: Text shell
POST /tools/pages-index Published-paper index page outputHtml: RepoPath, paperEmbed: RepoPath, pdf: RepoPath, md?: RepoPath, visualizer?: RepoPath, branch?: Branch, repo?: RepoFullName, sha?: CommitSha index?: RepoPath shell
POST /tools/pages-publish GitHub Pages publish directory: RepoPath, baseUrl?: Url url?: Url shell
POST /tools/pdf-cover PDF page raster pdf: RepoPath, out: RepoPath, page?: Count, width?: Count, checkOnly?: Flag facts?: Text shell
POST /tools/pdf-viewer-embed Embed a PDF inline in a page spec: Text fragment?: Text shell
POST /tools/pdf-viewer-install Install the inline PDF viewer into a built site site: RepoPath, allow: Url, zip?: RepoPath summary?: Text shell
POST /tools/pin-actions Pin third-party GitHub Actions to full commit SHAs dry-run?: Flag pinned?: Count shell
POST /tools/pin-spdx-license-list Snapshot the SPDX License List at its pinned version licenseListCheckout: FilesystemPath snapshot?: RepoPath shell
POST /tools/processes-viewer Processes viewer check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/public-comment-changesets Public-comment change-sets operation: ChangeSetAction, store?: RepoPath changesets?: RepoPath shell
POST /tools/publish-extracted-statements Publish extracted statements with source links page: RepoPath, check?: Flag, instance-root?: RepoPath page?: RepoPath shell
POST /tools/publish-gh-pages Publish a built site to gh-pages as a full replace site: RepoPath, state: RepoPath, commit: CommitSha, pagesDir: RepoPath result?: Text shell
POST /tools/qa-sweep QA sweep targetPath: RepoPath, dryRun?: Flag, ci?: Flag, json?: Flag sidecars?: RepoPath shell
POST /tools/rail-standalone-pages Give every page Jekyll did not lay out the folio-assistant navbar site: RepoPath, built: Slug, foreign-site?: Flag, instance?: Slug railed?: Count shell
POST /tools/readme-audit Audit README links file?: RepoPath, fetch?: Flag, dir?: FilesystemPath findings?: Markdown inProcess, mcp, shell
POST /tools/readme-sync Sync generated README sections check?: Flag, only?: ReadmeSection, link_style?: LinkStyle, fetch?: Flag, dir?: FilesystemPath report?: Markdown inProcess, mcp, shell
POST /tools/references-extract Reference lists to reference nodes instance: RepoPath, entry?: RepoPath, check?: Flag references?: RepoPath shell
POST /tools/references-render Reference list from reference nodes instance: RepoPath, check?: Flag blocks?: RepoPath shell
POST /tools/release-please release-please (declared, not configured here) package: PackageName, repo?: RepoFullName tag?: Text shell
POST /tools/remote-mount Mount remote harnesses at a pinned commit, only when trusted instance?: RepoPath, staging?: Flag, check?: Flag, noAgentSurface?: Flag, noInstall?: Flag, seed?: MountSeed, fresh?: Flag, choose?: MountChoice, directories?: IdList, tools?: IdList, consentBy?: Login, evidence?: Text outcomes?: Count shell
POST /tools/render-log Record what the publish branch served dir: RepoPath, event: RenderEvent, kind: Slug, path: RepoPath, slug?: Slug, branch?: Branch, commit?: CommitSha, run?: Url, prose: Markdown entry?: RepoPath shell
POST /tools/render-order The render pipeline, in dependency order dry_run?: Flag report?: Markdown inProcess, mcp, shell
POST /tools/review-log-watch Check a review log and its repository’s issues for changes repo: RepoPath, sheet: RepoPath, state: RepoPath, issues?: RepoPath, author?: RepoPath, sheetHash?: RepoPath, label?: RepoPath, skipLabel?: RepoPath result?: RepoPath shell
POST /tools/review-sheet-sync Build the review sheet’s Apps Script and a document’s Config tab script?: RepoPath, repo?: RepoPath, config?: RepoPath, out?: RepoPath script?: RepoPath, configRows?: RepoPath shell
POST /tools/rewrite-moved-paths Rewrite paths that still name a moved file’s old layer — never in a record fromName: Slug, fromRoot: RepoPath, toName: Slug, toRoot: RepoPath, prefix: RepoPath, scan?: RepoPath, write?: Flag, check?: Flag rewrites?: Count shell
POST /tools/schema-docs Skill contract reference check?: Flag schemaReference?: RepoPath shell
POST /tools/schemas-viewer Schemas viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/search-graph Lexical search over the content graph query: Text, provenance?: Slug, searchText?: Flag, limit?: Count result?: Markdown inProcess, mcp
POST /tools/secrets-check Check declared credential needs against workflow use and expiry, by name repos?: RepoPath, json?: Flag verdict?: Flag shell
POST /tools/security-gate Run every existing security check as one named release step json?: Flag blocked?: Flag shell
POST /tools/separation-cutover-check Is this repository’s cutover from the monorepo complete? Measured, condition by condition root?: RepoPath, site?: Flag, monorepo?: RepoFullName, monorepoDir?: Slug, json?: Flag conditions?: Count shell
POST /tools/serve-rendering Local rendering server directory?: RepoPath, port?: Port url?: Url shell
POST /tools/serve-rendering-py Local rendering server (Python) directory?: RepoPath, port?: Port url?: Url shell
POST /tools/shared-assets Stage a site’s shared asset directories where the host serves them site: RepoPath, out: RepoPath staged?: Text shell
POST /tools/sibling-sessions Sibling sessions in a window since?: TimeWindow, json?: Flag report?: Markdown, result?: SessionSweep inProcess, shell
POST /tools/site-build-local Build the docs site locally dest?: RepoPath site?: RepoPath shell
POST /tools/site-search-index Site search index — index?: RepoPath shell
POST /tools/site-search-scopes Site search scopes index: RepoPath scopes?: RepoPath shell
POST /tools/site-viewer Published site viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/skill-docs Skill instruction reference check?: Flag skillInstructions?: RepoPath shell
POST /tools/skill-fetch Fetch a skill skill: SkillName, package_name?: PackageName instructions?: Markdown inProcess, mcp
POST /tools/skill-list List skills — skills?: Markdown inProcess, mcp
POST /tools/skill-update Edit a skill skill: SkillName, package_name?: PackageName, new_content: Markdown, base_sha256: Text, reason: Text, actor?: Text, process?: ProcessId, task?: NodeId, role?: Text verdict?: Markdown, activity?: ProvActivity inProcess, mcp
POST /tools/slice-sqlite Per-slice SQLite builder slice?: Slug, out?: RepoPath, payloadOut?: RepoPath, check?: Flag slices?: RepoPath, report?: Text shell
POST /tools/smart-approach-svg WHO SMART Guidelines approach chart figure: RepoPath, out?: RepoPath svg?: RepoPath shell
POST /tools/stage-local Publish a folio’s or an IG’s site from the agent’s own checkout — the one agent publish path repo?: RepoPath, branch?: Branch, base?: Branch, main?: Flag, plan?: Flag, dryRun?: Flag, artifact?: RepoPath, workflowSource?: RepoPath, publisher?: Slug, runUrl?: Url url?: Url shell
POST /tools/staging-graph-viewer Staging-only graph viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/stakeholder-map Stakeholder map paths: RepoPath stakeholders?: Markdown inProcess, mcp, shell
POST /tools/state-viewer State graph viewer check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/sub-kg-verify-clone Verify a separated repository from a fresh clone repo: RepoFullName, ref?: Branch, sibling?: RepoFullName, work?: RepoPath, text?: Flag report?: Text shell
POST /tools/subgraph-index-package Package one pin’s subgraph index files for a hydrated mount root: RepoPath, repository: RepoFullName, ref: CommitSha, outDir: RepoPath, builtIn?: PinnedRepo tarball?: RepoPath, release?: RepoPath shell
POST /tools/subgraph-readmes Directory READMEs from the Knowledge Graph check?: Flag readmes?: RepoPath shell
POST /tools/subgraph-resolve Resolve a declared subgraph’s content source id?: Slug, all?: Flag, json?: Flag source?: Text shell
POST /tools/tabular-csv CSV tabular metadata file: DelimitedTextPath, doc-id?: DocId, out?: RepoPath record?: Text shell
POST /tools/tabular-xlsx Spreadsheet tabular metadata file: WorkbookPath, doc-id?: DocId, out?: RepoPath record?: Text shell
POST /tools/theme-viewer Themes viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/themes-css Theme stylesheet check?: Flag stylesheet?: RepoPath shell
POST /tools/tool-coverage Which uncovered skills warrant a Tool? — triage?: Text shell
POST /tools/tool-schema Tool node schema baseUrl?: Url schema?: RepoPath shell
POST /tools/tool-types-schema Tool I/O type vocabulary baseUrl?: Url schema?: RepoPath shell
POST /tools/tools-viewer Tools viewer check?: Flag, site?: RepoPath, scope?: IdList pages?: RepoPath shell
POST /tools/transcribe-faster-whisper Transcribe audio — faster-whisper (option, not installed) file: RepoPath, language?: Locale transcript?: RepoPath shell
POST /tools/transcribe-vosk Transcribe audio — vosk (option, not installed) file: RepoPath, language?: Locale transcript?: RepoPath shell
POST /tools/transcribe-whisper-cpp Transcribe audio — whisper.cpp (option, not installed) file: RepoPath, language?: Locale transcript?: RepoPath shell
POST /tools/translation-adjudicate Record a translation adjudication root?: RepoPath, event?: FilesystemPath, dry_run?: Flag records?: RepoPath, summary?: Markdown shell
POST /tools/translation-adjudication-workflow Translation adjudication workflow (reusable) path_in_repo?: RepoPath, index_ref?: Branch, tools_ref?: Text pull_request?: Url, summary?: Markdown manual
POST /tools/translation-candidates Collect candidate translations from open engines instance?: RepoPath, engines: IdList, url?: Url, locales?: IdList, init?: Flag, noCreateNode?: Flag, noMask?: Flag, dryRun?: Flag candidates?: RepoPath, catalogues?: RepoPath shell
POST /tools/translation-candidates-agent Candidate translations — agent model instance?: RepoPath, locales?: IdList candidates?: RepoPath, catalogues?: RepoPath manual
POST /tools/translation-extract Extract translatable strings path: RepoPath, locale?: Locale, project_name?: Text pot?: RepoPath inProcess, mcp
POST /tools/translation-inject Inject translations source: RepoPath, po_file: RepoPath, locale: Locale translated?: RepoPath inProcess, mcp
POST /tools/translation-platforms Exchange catalogues with a translation platform action: Slug, platform: Slug, root?: RepoPath, base?: Branch, write?: Flag, check?: Flag, dry_run?: Flag summary?: Markdown shell
POST /tools/translation-qa-prune Prune round-trip rulings of removed strings write?: Flag, ref?: Branch attestations?: RepoPath shell
POST /tools/translation-review-page Translation review page page: Url issue?: Url manual
POST /tools/translation-roundtrip-record Record a round-trip translation verdict payload: RepoPath sidecar?: RepoPath shell
POST /tools/translation-signoff Sign off a translation locale: Locale, source: RepoPath, signed_off_by: Text, level?: TranslationLevel record?: Markdown inProcess, mcp
POST /tools/translation-status Translation coverage locale?: Locale coverage?: Markdown inProcess, mcp
POST /tools/translation-status-viewer Translation status viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/translation-validate Validate a translation pot_file: RepoPath, po_file: RepoPath, source?: RepoPath findings?: Markdown inProcess, mcp
POST /tools/uml-object-model Harness object model as PlantUML check?: Flag diagram?: RepoPath shell
POST /tools/uml-overview UML overview per named sub-graph check?: Flag diagrams?: RepoPath shell
POST /tools/upload-url Where to drop a file — the queue’s upload URL branch?: Branch url?: Text shell
POST /tools/uploads-viewer Uploads viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/user-auth Who is asking, and what may they do actor?: Text, action?: Text, process?: Text, task?: Text, role?: Text, target?: Text answer?: Markdown inProcess, mcp
POST /tools/vocab-map Apply a vocabulary mapping table table: Slug, record: Text properties?: Text inProcess
POST /tools/voices-viewer Voices viewer check?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/web-app-build Web app build check?: Flag, extract?: Flag, site?: RepoPath pages?: RepoPath shell
POST /tools/wireframe-check Wireframe check at web and mobile viewports use: WireframeUse, topic: Slug, surface: SurfaceRef, candidates?: RepoPath, out?: RepoPath report?: RepoPath shell
POST /tools/witness-conformance Witness conformance report dir?: RepoPath, json?: Flag, strict?: Flag report?: Text shell
POST /tools/work-plan-prime Prime the work plan — priming?: Markdown inProcess, mcp, shell
POST /tools/workflow-complete Complete a step instance: InstanceId, node: NodeId, outcome?: NodeId, facts?: DecisionFacts, actor?: Text, target?: Text, note?: Markdown, activities?: ProvActivity position?: Markdown inProcess, mcp
POST /tools/workflow-gate May this step be performed? instance: InstanceId, activity: NodeId, actor?: Text, target?: Text verdict?: Markdown inProcess, mcp
POST /tools/workflow-list List processes — processes?: Markdown inProcess, mcp
POST /tools/workflow-next What is enabled now instance: InstanceId enabled?: Markdown inProcess, mcp
POST /tools/workflow-start Start a process instance process: ProcessId, subject: Text, bean?: BeanId, plan?: BeanId instance?: InstanceId inProcess, mcp

MCP tools (34)

MCP tool description parameters Tool read from
auth_whoami Who is asking, and what may they do? Asks GitHub for the caller’s login and repository role, maps the role to a gateway actor, and answers from the ODRL policies: unscoped grants, an action (optional… actor?: string, action?: string, process?: string, task?: string, role?: string, target?: string user-auth registrar
bean_query Query the beans knowledge graph using named graph analytics or arbitrary SPARQL 1.1. Available named queries: safe_drain_candidates, actionable_leaves, critical_path_blockers, epic_burndown, rollup_i… named?: string, sparql?: string, format?: string bean-query registrar
corpus_search Search the authored corpus AND the ingested library together, then follow the graph out from what matched. Reach for this before declaring anything open, unproved or novel. A block one uses hop fro… query: string, hops?: integer, direction?: string, provenance?: string, searchText?: boolean, limit?: integer corpus-search registrar
folio_init Scaffold a new folio (content repository) that uses folio-assistant: folio/, uploads/, library/, the document + chapter + first block manifests, .json and index.config.json (the instance config… title: string, authors: array, content_type?: string, slug?: string, dir?: string, link?: string, assistant_path?: string, force?: boolean, dry_run?: boolean folio-init registrar
get_graph_stats Node and edge counts for the content graph by provenance and kind, and whether each root exists. Use it to tell ‘nothing matched’ from ‘that population has not been built yet’. refresh?: boolean get-graph-stats registrar
get_neighbors Walk the content graph from one node. direction ‘out’ answers ‘what must a reader have read first?’; ‘in’ answers ‘what breaks if this changes?’. Accepts an @id or an authored label such as ‘thm:main… id: string, direction?: string, hops?: integer, edges?: array get-neighbors registrar
lsi_query Latent Semantic Indexing over a declared prose graph (a library, the skills, the beans, docs): find units that discuss the query in OTHER words. Run the lexical search first; this is the supplement f… text: string, instance?: string, graph?: string, top?: integer lsi-query registrar
memory_checkpoint Before you stop or hand over, keep where the work stands: what is done, what is next, and anything the next person must know to carry on. note: string, shared?: boolean memory-checkpoint registrar
memory_note Keep a short note on the work you are doing — what you did, what you decided and why, and what is left open — so it is there when this work is picked up again, by you or by someone else. note: string, shared?: boolean memory-note registrar
memory_recall Read what has been kept about this work so far, oldest first, so you can start where the last person stopped. shared?: boolean memory-recall registrar
readme_audit Verify every Markdown link in the folio’s README (or another file) still resolves: relative paths against the working tree, links naming one of the repo’s own refs against a real listing of that ref,… file?: string, fetch?: boolean, dir?: string readme-audit registrar
readme_sync Refresh the generated sections of the folio’s README. Each section is written ONLY where the README already carries its marker pair (<!-- folio:toc:begin --> … <!-- folio:toc:end -->), so nothing… check?: boolean, only?: array, link_style?: string, fetch?: boolean, dir?: string readme-sync registrar
render_order Flatten this repository’s renders into the order their needs imply, and run them unless dry_run. Stage 1 — the current declared state as json/jsonld, then the README derived from it — is FATAL: a… dry_run?: boolean render-order registrar
search_graph Lexical search over the JSON-LD content graph, across authored blocks and ingested library documents. No graph expansion; corpus_search composes this with a neighbour walk. query: string, provenance?: string, searchText?: boolean, limit?: integer search-graph registrar
skill_fetch Fetch a skill’s instruction body for the agent to follow. Serves the local platform bundles (package_name ‘folio-assistant’ = agent skills, ‘content-lifecycle’ = the plan/author/validate/review/test/… skill: string, package_name?: string skill-fetch registrar
skill_list List available skills WITH their one-line summaries — the local platform bundles (folio-assistant, content-lifecycle, folio-core, folio-document-adapter, folio-paper-adapter, authoring-who-smart-guid… — skill-list registrar
skill_update Edit an existing local skill through a governed gate instead of a raw file write (folio-assistant#875). Every gate must pass: the skill resolves as skill_fetch serves it, it is tracked in this reposi… skill: string, package_name?: string, new_content: string, base_sha256: string, reason: string, actor?: string, process?: string, task?: string, role?: string skill-update registrar
stakeholder_map Given the paths a proposed change touches, report which skills change, which roles those skills declare, and which BPMN process lanes — i.e. which accountable actors — reach work that uses them. Use … paths: array stakeholder-map registrar
translation_extract Extract translatable strings from a markdown file or directory into a GNU gettext .pot template. Segments prose by paragraph, strips inline formatting, skips code blocks and front matter. Output goes… path: string, locale?: string, project_name?: string translation-extract registrar
translation_inject Inject translations from a .po file into the source markdown, producing a translated copy. Uses the same state machine as extraction to identify translatable spans, looks up each span’s msgid in the … source: string, po_file: string, locale: string translation-inject registrar
translation_signoff Sign off a translation as official. Records who signed off, when, and the SHA-256 hash of the source .md for staleness detection. Updates translations//status.json. Use after SME review confi… locale: string, source: string, signed_off_by: string, level?: string translation-signoff registrar
translation_status Report translation coverage for a given locale. Scans the translations/ directory for .po files and computes per-file and aggregate statistics: total strings, translated, untranslated, fuzzy. Also re… locale?: string translation-status registrar
translation_validate Validate a translated .po file against its source .pot. Checks: (1) all msgids from the POT have a corresponding PO entry, (2) no orphaned placeholder tokens in translations, (3) structural consisten… pot_file: string, po_file: string, source?: string translation-validate registrar
work_plan_prime Prime yourself with the current beans work-plan (session + cross-session/cross-agent todos). Runs beans prime + beans list; if the beans CLI is not installed, falls back to reading the committed … — work-plan-prime registrar
workflow_complete Record that an enabled step is done, or answer a decision, and advance the process. Refuses a step that is not currently enabled — that refusal is the point: it is what keeps work from being claimed … instance: string, node: string, outcome?: string, facts?: object, actor?: string, target?: string, note?: string, activities?: array workflow-complete registrar
workflow_complete Record that an enabled step is done, or answer a decision, and advance the process. Refuses a step that is not currently enabled — that refusal is the point: it is what keeps work from being claimed … instance: string, node: string, outcome?: string, facts?: object, actor?: string, target?: string, note?: string, activities?: array bpmn-engine registrar
workflow_gate May a step be performed right now? Ask before doing work a strict process governs. The content-agnostic processes (editing, publication, lifecycle) enforce: a step that is not enabled is refused unle… instance: string, activity: string, actor?: string, target?: string workflow-gate registrar
workflow_gate May a step be performed right now? Ask before doing work a strict process governs. The content-agnostic processes (editing, publication, lifecycle) enforce: a step that is not enabled is refused unle… instance: string, activity: string, actor?: string, target?: string bpmn-engine registrar
workflow_list List the BPMN processes this folio defines, across every directory it declares as holding its knowledge graph, and any instances currently open. Use before workflow_start to see what exists. — workflow-list registrar
workflow_list List the BPMN processes this folio defines, across every directory it declares as holding its knowledge graph, and any instances currently open. Use before workflow_start to see what exists. — bpmn-engine registrar
workflow_next What is enabled RIGHT NOW in an instance — the activities that may be worked, with the lane (role) that performs each and the skill that implements it, plus any decision waiting on an outcome. Derive… instance: string workflow-next registrar
workflow_next What is enabled RIGHT NOW in an instance — the activities that may be worked, with the lane (role) that performs each and the skill that implements it, plus any decision waiting on an outcome. Derive… instance: string bpmn-engine registrar
workflow_start Begin a process instance for a subject (a block label, a release, a bean id). Idempotent: an instance already open for the same process and subject is returned rather than duplicated. Returns what is… process: string, subject: string, bean?: string, plan?: string workflow-start registrar
workflow_start Begin a process instance for a subject (a block label, a release, a bean id). Idempotent: an instance already open for the same process and subject is returned rather than duplicated. Returns what is… process: string, subject: string, bean?: string, plan?: string bpmn-engine registrar