How do I use unseen-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@unseen-mcp turn this incident playbook into a cited visual workflow" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

unseen-mcp

by eyeinthesky6

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

Unseen MCP Server (`unseen-mcp`)

The official Model Context Protocol (MCP) server for Unseen (unseendocs.in).

Turn messy operational documents, standard operating procedures (SOPs), incident playbooks, spreadsheets, and business communications into faithful, source-grounded visual workflows directly inside Claude Desktop, Cursor, Zed, Windsurf, or any MCP-compatible agent.

Capabilities

The unseen-mcp server provides 3 primary tools:

compile_workflow: Compiles raw text, SOPs, or multi-page documents into a structured, verifiable VisualSpec workflow graph, accompanied by production-ready SVG and Mermaid syntax.
- Arguments: content (string, required), title (string, optional).
revise_workflow: Applies focused revisions or node additions/modifications to an existing workflow graph while preserving citation integrity.
- Arguments: visualSpec (object, required), instructions (string, required).
get_workflow: Retrieves the full structured representation of an existing visual artifact by its ID.
- Arguments: id (string, required).

Related MCP server: obscuraai-mcp

1-Click Installation (Smithery)

If you use Smithery.ai:

npx -y @smithery/cli install unseen-mcp --client claude

Or for Cursor:

npx -y @smithery/cli install unseen-mcp --client cursor

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unseen": {
      "command": "npx",
      "args": ["-y", "unseen-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-your-openrouter-key",
        "TYPESAFE_API_KEY": "your-optional-typesafe-key"
      }
    }
  }
}

Cursor IDE Configuration

In Cursor Settings -> Features -> MCP:

Click + Add New MCP Server.
Name: unseen
Type: command
Command: npx -y unseen-mcp
Add environment variables:
- OPENROUTER_API_KEY: Your OpenRouter API key

Environment Variables

Variable	Description	Required?
`OPENROUTER_API_KEY`	OpenRouter API key for LLM-assisted document compilation	Recommended for rich natural language compilation (falls back to deterministic heuristics if absent)
`TYPESAFE_API_KEY`	TypeSafe API key for Jev semantic audits and missing branch recovery	Optional

Running Locally

To run the stdio server directly from the command line:

npx -y unseen-mcp

Or build from source in the unseen repository:

git clone https://github.com/eyeinthesky6/unseen.git
cd unseen
npm install
npm run build:mcp
node dist-mcp/index.cjs

License

MIT © Unseen

Available Tools

9 tools

auth_loginSign In with Email + PasswordAInspect

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.

Inputs: email (required), password (required), name, register.

auth_request_otpRequest Agent & Human Login OTP (Email + OTP)AInspect

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.

Inputs: email (required).

auth_verify_otpVerify Agent & Human Login OTPAInspect

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.

Inputs: otp (required), email (required).

autofix_workflowAutofix & Re-Render Workflow ($0 Free)A

Idempotent

Inspect

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.

Inputs: spec (required), authToken, orientation.

compile_workflowCompile Workflow DiagramAInspect

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.

Inputs: sources (required), userGoal (required), schemaVersion (required), text, +6 more.

detect_workflowsDetect Candidate Workflows in DocumentA

Read-onlyIdempotent

Inspect

Discover distinct operational workflows from multi-section documents or raw text before compiling. Returns candidate workflows (id, title, description, sourceIds) audited by TypeSafe Jev.

Inputs: text, sources, authToken.

enhance_workflowAI Enhance Workflow (TypeSafe Jev Audit & Repair)AInspect

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.

Inputs: spec (required), visualId, authToken.

get_workflowGet Compiled WorkflowA

Read-onlyIdempotent

Inspect

Retrieve an existing VisualSpec workflow by jobId or visualId, returning the spec, SVG layout, and Mermaid diagram.

Inputs: id (required), authToken.

revise_workflowRevise Workflow DiagramA

Idempotent

Inspect

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.

Inputs: spec (required), instruction (required), authToken, additionalSources.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored 2026-10-23 12:40 across 9 tools

Disambiguation4/5

Most tools have clear boundaries: detection, compilation, retrieval, revision, deterministic repair, semantic enhancement, and authentication are distinct operations. The main ambiguity is among revise_workflow, autofix_workflow, and enhance_workflow, since all can modify and return diagram artifacts, though their descriptions clarify structural delta edits vs deterministic connector healing vs semantic verification.

Naming Consistency5/5

Tool names consistently use snake_case with clear verb_noun phrasing: compile_workflow, revise_workflow, autofix_workflow, enhance_workflow, detect_workflows, get_workflow. The auth_* prefix groups authentication tools predictably.

Tool Count5/5

Nine tools is well-scoped for a workflow-diagram generation server, covering the core workflow lifecycle plus login. No tools appear redundant or unnecessary, and the count is within a manageable range for agent selection.

Completeness4/5

The surface covers the main workflow lifecycle: discovery, compilation, retrieval, revision, deterministic repair, and semantic enhancement, plus authentication. Minor gaps remain, such as listing/searching existing workflows or deleting/archiving them, but core agent workflows are covered.

Maintenance

ActivityNo data

ResponsivenessOutdated data

Resources

Related MCP Connectors

agentdocs
io.github.dancourse
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
Workplace & Productivity Documentation Access
2
https://getagentdocs.com/mcp
Wireflow MCP server
ai.wireflow
Connect Claude or any MCP client to Wireflow, the AI canvas for image, video and audio workflows. List, build, inspect and run your workflows and published apps, browse templates, check models, prices and credits, edit a video node's timeline, and plan or schedule social posts. Drafts and edits cost no credits; run tools spend the user's credits.
AI & Machine Learning App Automation Multimedia Processing
1
https://www.wireflow.ai/api/mcp
LiveContext
ai.livecontext
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.
Agent Orchestration App Automation Data Platforms
1
https://livecontext.ai/mcp
Context OSB
top.contextlm
Ask your own documents and get answers that cite the source passage. Workspace knowledge bases over MCP for Cursor, Claude and any MCP client.
Knowledge & Memory RAG Systems Search
161
https://app.contextlm.top/api/v1/mcp

Related MCP Servers

Agentled MCP Server
Agent Orchestration AI & Machine Learning Knowledge & Memory
Agentled
A
license
A
quality
C
maintenance
AI workflow orchestration platform with 100+ integrations, knowledge graph, and unified credits. Build, manage, and execute workflows from Claude Code, Cursor, or any MCP client.
Updated a month ago (2026-10-15 20:59 UTC)
40
276 npm
3
MIT
obscuraai-mcp
Autonomous Agents App Automation Workplace & Productivity
madeinphantom
A
license
B
quality
D
maintenance
MCP server for Claude, ChatGPT, coding agents (cursor, claude code etc), windsurf, etc— generate visual AI automation workflows. Describe a business process, get an interactive flow map you can edit and share.
Updated 7 months ago (2026-04-10 11:39 UTC)
1
78 npm
MIT
Cortex
Knowledge & Memory Search Note Taking
liveevilkin
A
license
Not graded
quality
D
maintenance
Obsidian-backed knowledge graph with semantic search, entity extraction, and cross-session memory. 11 MCP tools. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible editor.
Updated 5 months ago (2026-06-19 11:03 UTC)
118 npm
1
MIT
Circuit
App Automation Autonomous Agents
brandononchain
A
license
Not graded
quality
B
maintenance
Enables building and running visual workflows conversationally inside Claude, orchestrating your existing connector tools step-by-step without storing credentials or owning integrations.
Updated 2 months ago (2026-09-20 01:23 UTC)
11 npm
MIT

Unseen MCP Server (unseen-mcp)

Capabilities

1-Click Installation (Smithery)

Claude Desktop Configuration

Cursor IDE Configuration

Environment Variables

Running Locally

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Agentled MCP Server

obscuraai-mcp

Cortex

Circuit

Unseen MCP Server (`unseen-mcp`)