# jotview

> jotview is a free MCP server for files and documents. Render markdown and Mermaid diagrams as shareable jotbins.com links, and read them back. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://mcp.jotbins.com
- **Repository:** https://github.com/jotbins/jotview
- **MCP Registry name:** io.github.jotbins/jotview
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

The core idea is that the document travels inside the link. Small documents are compressed into the part of the URL after the #, so they never reach a server and never expire. Links over about 500 characters through the hosted server are uploaded to surl.jotbins.com to get a short link, and those short links are deleted after 30 days without a visit unless you ask the assistant to keep them.

The server exposes two tools, render_markdown and read_link. render_markdown takes the markdown plus optional title, keep and shorten settings, and returns a link named after the first heading. read_link opens a jotbins link you paste, so the assistant can edit it; an edit produces a new link and the old one never changes.

It runs either as a remote endpoint with no sign-in or API key, or locally through the npm package over stdio. The README lists setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf and Gemini CLI.

## Features

- **Markdown to link:** Turns notes or reports into a rendered jotbins.com link.
- **Mermaid diagrams:** Diagrams written in Mermaid render on the linked page.
- **Read links back:** Pasted jotbins links can be decoded so an assistant can revise them.
- **Local-first links:** Small documents stay entirely inside the URL fragment.
- **Shortening control:** Choose auto, always or never shortening, and keep a short link permanently.
- **Remote or local:** Use the hosted endpoint or run the npm package over stdio.

## Good for

- Share a deploy checklist as a link
- Draw a login flow as a sequence diagram
- Fix typos in an existing jotbins link
- Hand off meeting notes without a file attachment

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http jotview https://mcp.jotbins.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.jotbins.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "jotview": {
      "url": "https://mcp.jotbins.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "jotview": {
      "type": "http",
      "url": "https://mcp.jotbins.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "jotview": {
      "serverUrl": "https://mcp.jotbins.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "jotview": {
      "type": "http",
      "url": "https://mcp.jotbins.com/mcp"
    }
  }
}
```

## Tools

- `render_markdown`: Renders markdown into a jotbins link, with optional title, keep and shorten settings.
- `read_link`: Reads the content behind a jotbins link you share.

## FAQ

### Does it need an account or API key?

No. The hosted endpoint needs no sign-in or API key.

### Is my document uploaded?

Small documents stay in the link and never reach a server. Longer ones are uploaded to surl.jotbins.com for a short link, unless you ask for no upload.

### How long do links last?

Full links never expire; short links are deleted after 30 days without a visit unless kept.

### Can I run it locally?

Yes, with npx -y jotview mcp, which needs Node 18 or newer.

### Which tools does it offer?

render_markdown and read_link.

### Is jotview free?

Yes. jotview is free to use.

### How do I add jotview to Claude Code?

Run this command in your terminal: claude mcp add --transport http jotview https://mcp.jotbins.com/mcp

### What are the best alternatives to jotview?

The closest alternatives to jotview are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/jotview
