# mdshare

> mdshare is a free MCP server for files and documents. Upload markdown, get permissioned share links, and collaborate without an account. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI, vscode
- **Website:** https://mdshare.live
- **Repository:** https://github.com/urbanmorph/mdshare
- **MCP Registry name:** io.github.sathya-sankaran/mdshare
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-14

## About

mdshare turns a markdown file into a link that people can open, comment on or edit, with no sign-up for either side. You can drop a .md file (up to 10 MB) on the site, post it with curl, or have an AI client upload it through the MCP server.

Each document gets separate links for admin, edit, comment and view access. Editors use a WYSIWYG editor, commenters anchor comments to text, and changes sync live over WebSocket with polling as fallback. Links can be revoked instantly or given an expiry, with up to 50 per document, and a version history shows who edited when.

The MCP server is the npm package mdshare-mcp, which runs locally over stdio with no API key, and a hosted endpoint is also listed. The README mentions plugins for Claude Code, Cursor, VS Code and Obsidian, and a REST API.

## Features

- **Four permission levels:** Separate admin, edit, comment and view links per document.
- **Inline comments:** Anchor, reply to and resolve comments on specific text.
- **Live sync:** Edits broadcast over WebSocket with presence indicators.
- **Link management:** Revoke links, set expiry, up to 50 links per document.
- **Version history:** See who edited a document and when.
- **REST API and plugins:** Use curl, or plugins for Claude Code, Cursor, VS Code and Obsidian.

## Good for

- Share an AI-written plan for review with comments
- Let a teammate edit a spec without creating an account
- Pipe converter output straight into a shareable link
- Hand a read-only draft to a client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mdshare https://mdshare.live/mcp
```

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

```sh
https://mdshare.live/mcp
```

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

```json
{
  "mcpServers": {
    "mdshare": {
      "url": "https://mdshare.live/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mdshare": {
      "type": "http",
      "url": "https://mdshare.live/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mdshare": {
      "serverUrl": "https://mdshare.live/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mdshare": {
      "type": "http",
      "url": "https://mdshare.live/mcp"
    }
  }
}
```

## Tools

- `read_document`: Read an mdshare document from its share link: the markdown, its title, what the link allows (view, comment or edit), the last edit and when it expires.
- `list_comments`: List the comments on an mdshare document from its share link: each comment's author, text, the passage it is anchored to, its replies and whether it is resolved.
- `get_versions`: Get the edit history of an mdshare document from its share link: who edited it, when, and how (web, API or an integration).

## FAQ

### Do I need an account?

No, neither the uploader nor the people you share with need one.

### How large can a file be?

Up to 10 MB, markdown only.

### Does the MCP server need a key?

No. mdshare-mcp needs no API key or environment variables.

### Can I revoke a link?

Yes, links can be revoked instantly or set to expire.

### Is mdshare free?

Yes. mdshare is free to use.

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

Run this command in your terminal: claude mcp add --transport http mdshare https://mdshare.live/mcp

### What are the best alternatives to mdshare?

The closest alternatives to mdshare are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

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