# Unseen Workflow Compiler

> Compile SOPs, policies, and playbooks into source-grounded visual flowcharts (SVG, Mermaid, JSON).

- name: io.github.eyeinthesky6/unseen-workflow-compiler
- version: 1.0.1
- connection class: R0 (autonomous)
- trust: 94/100
- quality: 72/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.eyeinthesky6%2Funseen-workflow-compiler
- tools: https://api.protogrid.dev/v1/servers/io.github.eyeinthesky6%2Funseen-workflow-compiler/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "unseen-workflow-compiler": {
      "type": "http",
      "url": "https://unseendocs.in/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 99
- freshness: 100
- provenance: 80
- drivers: +repository +namespace-matches-repo +reachable +uptime-98% +updated-16d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 72/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 9 of 9 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,746 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 6 tool changes in 30 days
- fail `stability.rug_pull`: 2 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 9, about 2,746 tokens to load them all
- tool set hash: c9a8b10a415c8a85e8fbccbb1d45eec8
- tools last changed: 2026-11-07T11:42:13.919Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.eyeinthesky6/unseen-workflow-compiler.svg)](https://protogrid.dev/servers/io.github.eyeinthesky6/unseen-workflow-compiler)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-07 `autofix_workflow` changed (description, inputSchema, annotations)
  - before: Deterministic connector healing and full visual re-rendering ($0 compute cost, instant, unlimited). Rescues orphan nodes, heals broken or missing decision branches, recomputes deterministic orthogonal layout, and returns fresh `spec`, `svg`, `mermaid`, `excalidraw`, and `studioUrl`. Use this tool after making direct structural edits to `VisualSpec` JSON (`nodes` / `edges`), or when a user asks to autofix connectors.
  - after: Deterministic connector healing and full visual re-rendering ($0 compute cost, instant, unlimited). Cleans exact duplicate edges and empty sequence labels, recomputes deterministic orthogonal layout, and returns fresh `spec`, `svg`, `mermaid`, `excalidraw`, and `studioUrl`. Missing steps or branches require source-backed edits to the spec; this tool preserves graph meaning and does not perform semantic verification. Use this tool after making direct structural edits to `VisualSpec` JSON (`nodes` / `edges`), or when a user asks to autofix connectors.
- 2026-11-07 `compile_workflow` changed (inputSchema)
- 2026-10-23 `auth_login` changed (description, inputSchema) **meaning changed**
  - before: Authenticate an existing Unseen account using `email` and `password` (or create one if `register: true`), returning `{ token: 'utok_...', user }` for use in `Authorization: Bearer <token>` or `authToken`.
  - after: Legacy sign-in for an existing password account. Account creation and password setup require verified browser sign-in. ChatGPT/Codex plugin connections use browser OAuth instead of this tool.
- 2026-10-23 `revise_workflow` changed (description) **meaning changed**
  - before: Apply targeted delta revisions to an existing VisualSpec workflow diagram (e.g. modify node labels, adjust roles like step vs decision, add/remove edges, or heal connections) while preserving Visual Contract v0.1 validity and source grounding.
  - after: Apply explicit node label/role changes or node removal using node IDs, or request connector autofix. For other changes, including new steps or edges, edit the returned spec with confirmed source evidence and call autofix_workflow. Unsupported instructions return an error; this tool does not perform general natural-language rewrites.
- 2026-10-23 `compile_workflow` changed (description)
  - before: Turn supplied document evidence or raw operational text into a publication-ready workflow diagram with source references, clean vector SVG, Mermaid, Excalidraw scene, and interactive Studio deep link (`studioUrl`). HOW TO STRUCTURE TEXT INPUTS: Either pass `sources` (array of 1..60 verbatim chunks `{id, locator, excerpt}` where each excerpt is <= 2000 chars with exact numbers/actors/thresholds preserved) OR pass raw `text` and Unseen will automatically segment it into source chunks. EDITING GUIDANCE: For cosmetic/styling/annotation edits, edit the returned `<svg>` XML directly. For structural/topological edits (adding/removing nodes or rerouting branches), edit `spec` (VisualSpec JSON) and call `autofix_workflow` ($0 deterministic connector healing + fresh SVG/Mermaid/Excalidraw) or `revise_workflow`.
  - after: Turn supplied document evidence or raw operational text into a publication-ready workflow diagram with source references, clean vector SVG, Mermaid, Excalidraw scene, and interactive Studio deep link (`studioUrl`). INPUT SCOPE: Use reviewed written procedures only. Do not interpret scans, images, chart/diagram geometry or unlabeled arrows, and do not certify business procedures. Ask for reviewed written process text or source-backed clarification. HOW TO STRUCTURE TEXT INPUTS: Either pass `sources` (array of 1..60 verbatim chunks `{id, locator, excerpt}` where each excerpt is <= 2000 chars with exact numbers/actors/thresholds preserved) OR pass raw `text` and Unseen will automatically segment it into source chunks. EDITING GUIDANCE: For cosmetic/styling/annotation edits, edit the returned `<svg>` XML directly. For structural/topological edits (adding/removing nodes or rerouting branches), edit `spec` (VisualSpec JSON) and call `autofix_workflow` ($0 deterministic connector healing + fresh SVG/Mermaid/Excalidraw) or `revise_workflow`.
- 2026-10-23 `autofix_workflow` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/io.github.eyeinthesky6%2Funseen-workflow-compiler/changes

## Remotes

- https://unseendocs.in/mcp (streamable-http, auth none, reachable true, uptime30d 0.984127)

## Packages

_none_

## Tools (9)

- `auth_login`: Legacy sign-in for an existing password account. Account creation and password setup require verified browser sign-in. ChatGPT/Codex plugin connections use browser OAuth instead of this tool.
- `auth_request_otp`: Step 1 of Agent & Human Login (Email + OTP): Sends a 6-digit Login OTP (`UNSEEN_LOGIN_OTP`) to the user's email address. This is a passwordless Login OTP (NOT a password reset). Once called, the agent can either read the 6-digit `UNSEEN_LOGIN_OTP` directly from the user's email (when the user has granted email access) or ask the user in chat for the 6-digit code, then call `auth_verify_otp`.
- `auth_verify_otp`: Step 2 of Agent & Human Login (Email + OTP): Verifies the 6-digit Login OTP sent to `email` and returns `{ token: 'utok_...', user }` (30 free credits / 3 visuals per month on new accounts). Pass the returned `token` as `Authorization: Bearer <token>` or in the `authToken` argument of subsequent MCP tool calls.
- `autofix_workflow`: Deterministic connector healing and full visual re-rendering ($0 compute cost, instant, unlimited). Cleans exact duplicate edges and empty sequence labels, recomputes deterministic orthogonal layout, and returns fresh `spec`, `svg`, `mermaid`, `excalidraw`, and `studioUrl`. Missing steps or branches require source-backed edits to the spec; this tool preserves graph meaning and does not perform semantic verification. Use this tool after making direct structural edits to `VisualSpec` JSON (`nodes` / `edges`), or when a user asks to autofix connectors.
- `compile_workflow`: Turn supplied document evidence or raw operational text into a publication-ready workflow diagram with source references, clean vector SVG, Mermaid, Excalidraw scene, and interactive Studio deep link (`studioUrl`). INPUT SCOPE: Use reviewed written procedures only. Do not interpret scans, images, chart/diagram geometry or unlabeled arrows, and do not certify business procedures. Ask for reviewed written process text or source-backed clarification. HOW TO STRUCTURE TEXT INPUTS: Either pass `sources` (array of 1..60 verbatim chunks `{id, locator, excerpt}` where each excerpt is <= 2000 chars with exact numbers/actors/thresholds preserved) OR pass raw `text` and Unseen will automatically segment it into source chunks. EDITING GUIDANCE: For cosmetic/styling/annotation edits, edit the returned `<svg>` XML directly. For structural/topological edits (adding/removing nodes or rerouting branches), edit `spec` (VisualSpec JSON) and call `autofix_workflow` ($0 deterministic connector healing + fresh SVG/Mermaid/Excalidraw) or `revise_workflow`.
- `detect_workflows`: Discover distinct operational workflows from multi-section documents or raw text before compiling. Returns candidate workflows (`id`, `title`, `description`, `sourceIds`) audited by TypeSafe Jev.
- `enhance_workflow`: Bundled free semantic verification and repair powered by TypeSafe Jev. Audits the VisualSpec against its cited `sources[]` for unsupported claims, missing decision branches, and role accuracy, applies targeted repair if actionable issues are found, and returns the enhanced `spec`, `svg`, `mermaid`, `excalidraw`, `studioUrl`, and Jev quality metrics.
- `get_workflow`: Retrieve an existing VisualSpec workflow by jobId or visualId, returning the spec, SVG layout, and Mermaid diagram.
- `revise_workflow`: Apply explicit node label/role changes or node removal using node IDs, or request connector autofix. For other changes, including new steps or edges, edit the returned spec with confirmed source evidence and call autofix_workflow. Unsupported instructions return an error; this tool does not perform general natural-language rewrites.