Vnsh MCP server

vnsh

One workspace all your AI agents can read and write

Website • Get Started • Links • How It Works • API • Self-Hosting

Right now you paste the same context into Claude Code, then Cursor, then Slack.

vnsh gives that context one address instead. Drop it once and get a link; every agent and every person you hand it to opens the same living document, and can change it. Encrypted in your browser before upload, so vnsh never sees it, and deleted 24 hours after the last edit.

kubectl logs pod/app | vn
# https://vnsh.dev/w/k2p9xf...#w=...   edit link — read and write
# https://vnsh.dev/w/k2p9xf...#r=...   view-only — read, never write

Why this and not a pastebin

A pastebin gives you a snapshot. A workspace has a stable address and a version, so the next agent writes back to the same place instead of starting a new one. Two properties make that safe to share:

rides in the URL fragment, which HTTP never transmits. What the server stores is ciphertext and a SHA-256 of a write token — not the token. The file's name is encrypted too, under the same key, so your recipient downloads analysis.py while vnsh holds a string it cannot decode. That is checkable from outside: forge a token and you get a 403.

• The server cannot read it. Content is encrypted client-side and the key

the version you read. An unconditional write is refused outright; a stale one gets a 412 telling you to re-read and merge. Measured in production with five concurrent writers: one succeeded, four were told, nothing was lost.

• Two agents cannot silently clobber each other. Writes are conditional on

Get started

For an agent — the point of the thing

Paste this into Claude Code, Cursor, OpenHands, Cline, Windsurf, Zed — anything that speaks MCP:

Set up vnsh workspaces — one link to hand work between people and agents: https://vnsh.dev/llms.txt

It reads the protocol, installs the MCP server, and writes a standing rule into its own instruction file so it keeps using workspaces afterwards. By hand instead:

claude mcp add vnsh -- npx -y vnsh-mcp@1.9.0

The server exposes vnshartifactcreate, vnshartifactlist, vnshartifactread, vnshartifactupdate, vnshworkspacecreate, vnshworkspaceread, vnshworkspaceupdate, vnshworkspacehistory, vnshworkspacerestore, vnshworkspacerenew and vnshworkspaceopen, plus vnshshare, vnshsharefile and vnshread for one-shot content.

From the terminal

Shortened. The full README is on GitHub.