The Tools of cat-harness-tools, 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 (1)

operationsummaryrequestresponsereached as
POST /tools/bpmn-engineBPMN workflow engineprocess: ProcessId, node?: NodeIdenabled?: NodeIdinProcess, mcp

MCP tools (5)

MCP tooldescriptionparametersToolread from
workflow_completeRecord 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?: arraybpmn-engineregistrar
workflow_gateMay 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?: stringbpmn-engineregistrar
workflow_listList 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-engineregistrar
workflow_nextWhat 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: stringbpmn-engineregistrar
workflow_startBegin 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?: stringbpmn-engineregistrar

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