mdshare
Manage mdshare markdown documents: upload, read, edit, comment, inspect history, and administer share links.
Upload markdown from a local file or inline content and receive a shareable link with view, comment, or edit permission.
Read documents inline or save them directly to disk.
Replace full document content or apply find/replace patch operations.
Generate, list, and revoke permission-specific share links.
List comments, post comments/replies with optional text anchors, and resolve or unresolve comments.
View document edit history.
List documents uploaded through this MCP server and retrieve their admin URLs only when explicitly requested.
Register an existing mdshare admin URL locally for future access without re-pasting the key.
Provides a plugin to share markdown documents from Obsidian editor to mdshare.live for instant sharing and collaboration.
mdshare
Share markdown as a link anyone can comment on and edit, with no account. Free: upload a file, get a link, and collaborate with comments, live edits and permission links.
mdshare.live | API docs | Use with AI | Plugins | About

Contents
Related MCP server: md-annotate
What it does
mdshare turns markdown into a shareable link. Paste or drop a .md file at mdshare.live, send it with curl, or let an AI client upload it through the MCP server. Neither you nor the people you share with need an account.
Each document gets links at four permission levels (admin, edit, comment, view). People with an edit link change the document in a WYSIWYG editor, people with a comment link anchor comments to text, and everyone with the document open sees changes as they happen.
Features
Four permission levels: admin, edit, comment and view, each with its own link.
WYSIWYG editor: formatting toolbar, tables, code blocks and keyboard shortcuts.
Inline comments: anchor a comment to specific text, reply, and resolve.
Real-time sync: changes broadcast over WebSocket with presence indicators; falls back to polling.
Link management: revoke links instantly, set optional expiry, up to 50 links per document.
Version history: see who edited and when.
Recent documents sync (optional): an encrypted copy of your recent-documents list, so it follows you across devices. It is encrypted in your browser; the server cannot read it.
REST API and MCP server: for scripts and for Claude, ChatGPT/Codex, Gemini CLI, Cursor and Windsurf.
Plugins: Claude Code, Cursor, VS Code and Obsidian.
Quick start
Web
Open mdshare.live, paste markdown or drop a .md file (up to 10 MB), and select Create & Get Share Links.
curl
curl -X POST https://mdshare.live/api/documents \
-H "Content-Type: text/markdown" \
--data-binary @your-file.mdThe response contains the document ID, an admin URL and the expiry date. Keep the admin URL private: it gives full control. From it you can create edit, comment or view links to share.
Any converter that writes markdown to stdout can pipe straight in. See Convert and share markdown for recipes with markitdown, pandoc, Docling, Marker, Firecrawl and Jina Reader.
MCP server
The MCP server is the npm package mdshare-mcp. It runs locally over stdio and needs no API key or environment variables.
npx mdshare-mcpAdd it to your client's MCP config:
{
"mcpServers": {
"mdshare": {
"command": "npx",
"args": ["mdshare-mcp"]
}
}
}Client | Config file |
Claude Desktop |
|
Claude Code | Use the plugin (no JSON to edit) |
Cursor |
|
Windsurf |
|
OpenAI Codex CLI |
|
Gemini CLI |
|
Then ask, for example, "upload my-notes.md to mdshare and give me a share link". The server reads files from disk by path, so large documents do not pass through the conversation. Full setup: mdshare.live/share-markdown-with-ai. Package docs: mcp/README.md.
No MCP client? Point any chatbot that can fetch URLs at the API:
Read https://mdshare.live/docs/raw to learn the mdshare API,
then upload this markdown and give me a share link.MCP tools
From mcp/index.js (v1.5.0):
Tool | What it does |
| Upload markdown by |
| Read a document; optionally save it to |
| Replace the content. Optional |
| Apply find/replace operations without resending the whole document. Optional |
| Create a view, edit or comment link. |
| List a document's share links and their status. |
| Revoke a share link permanently. |
| Change when the document auto-deletes (a future date, at most one year out). |
| List comments, replies and resolution status. |
| Add a comment, optionally anchored to text. |
| Resolve or reopen a comment. |
| Show edit history (who and when). |
| List documents uploaded through this server on this machine. |
| Return the admin URL of a stored document, only when the user asks for it. |
| Add a previously saved admin URL to the local store. |
Admin credentials for documents uploaded through the server are kept in ~/.mdshare-mcp/documents.json (mode 0600), so upload_markdown returns only the share link and later calls need just the document ID.
Listed in the official MCP Registry as io.github.sathya-sankaran/mdshare, on Glama, and in awesome-mcp-servers.
Plugins
Claude Code
/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorphWraps the MCP server with one skill, mdshare-tools, that Claude uses on requests like "share this markdown". Setup guide | source
Cursor
Listed on Cursor Directory: select Add to Cursor on the listing. Same MCP server and skill as the Claude Code plugin. Source
VS Code
Search for mdshare in the Extensions panel, or install from the Marketplace page. Right-click a .md file and choose Share on mdshare, or share a selection. Also works in Cursor and Windsurf. Guide | source
Obsidian
Listed in the Obsidian Community Plugins directory: Settings > Community Plugins > Browse, search for "mdshare". Right-click a file to share it; the admin URL is copied to your clipboard. Guide | source
API
Base URL: https://mdshare.live. Full reference at mdshare.live/docs (plain text for LLMs at /docs/raw).
Action | Request |
Upload |
|
Read |
|
Update |
|
Patch |
|
Links |
|
Comments |
|
Versions |
|
Limits: 10 MB per document; 10 creates per minute and 50 per day per IP; 30 updates per minute; 20 comments per minute; 50 links per document. A 429 includes Retry-After; an expired document returns 410.
Privacy and permissions
No accounts. The link is the only access control. Anyone with a link has that link's permission, so do not share sensitive content.
Permission levels:
adm_full control,edt_read and write,cmt_read and comment,viw_read only. Each link can be revoked or given its own expiry.Tokens are hashed. Requests are checked against a SHA-256 hash of the token. The stored copy of each share token (kept so admins can list links) is encrypted with AES-GCM under a Worker secret.
Content is sanitized on the server before it is stored.
Documents expire 90 days after creation by default. The admin can move the expiry to any future date up to a year out. A daily job deletes expired documents with their comments, versions and links.
What is collected: document content, comments with the display name the commenter chooses, transient IP and user-agent logs at Cloudflare for abuse detection, and aggregate page-view counts through Cloudflare Web Analytics (no cookies). No email addresses, trackers or profiles.
Full policy, including GDPR and DPDPA rights: mdshare.live/privacy.
Architecture
Component | Technology |
Framework | Astro 5 (static pages pre-rendered, API routes on the Worker) |
UI | React 19 as Astro islands |
Hosting | Cloudflare Workers |
Database | Cloudflare D1 (SQLite) |
Real-time | Cloudflare Durable Objects (WebSocket) |
Editor | Tiptap with tiptap-markdown |
Styling | Tailwind CSS v4 |
CI/CD | GitHub Actions |
Layout:
src/pages/ Astro pages; src/pages/api/ holds the REST API
src/worker.ts Worker entry: WebSocket routing, security headers, daily cleanup cron
worker/ DocumentWebSocket Durable Object
lib/ sanitization, tokens, permissions, D1 access, rate limits
components/ Tiptap editor, toolbar, comments, link manager
migrations/ D1 schema migrations
mcp/ mdshare-mcp npm package
plugins/ Claude Code and Cursor pluginsDevelopment
Requires Node.js 22 (the version CI uses).
git clone https://github.com/urbanmorph/mdshare.git
cd mdshare
npm install
# Create the local D1 database schema
npm run db:migrate:local
# Build and serve on http://localhost:3737
npm run devOptional: put TOKEN_ENC_KEY (a base64-encoded AES key, for example from openssl rand -base64 32) in .dev.vars to encrypt stored share tokens locally. Without it, tokens are stored unencrypted and a warning is logged.
Command | What it does |
|
|
| Build the site into |
| Run the unit tests ( |
| Run ESLint |
| Regenerate |
Deploy
Every push to main runs .github/workflows/deploy.yml: npm ci, astro build, apply D1 migrations to the remote database, then wrangler deploy. It needs the repository secrets CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID. Set TOKEN_ENC_KEY as a Worker secret (npx wrangler secret put TOKEN_ENC_KEY) to encrypt stored share tokens.
To deploy by hand with your own Cloudflare account, create a D1 database, set its ID in wrangler.jsonc, then:
npm run db:migrate # apply migrations to the remote D1 database
npm run deploy # astro build && wrangler deployContributing
Issues and pull requests are welcome. Please open an issue first to discuss significant changes. mdshare is deliberately minimal: a feature should make upload, share and collaborate faster or clearer without adding UI clutter (see CLAUDE.md for the design principles).
Before opening a PR, run npm test and npm run lint.
License
MIT © 2026 UrbanMorph
Available Tools
14 toolsgenerate_linkAInspect
Generate a share link for a document with specific permissions. Requires admin access. If the document is in this MCP server's local store, 'key' is optional.
Inputs: document_id (required), permission (required), key, label.
get_admin_urlARead-onlyIdempotentInspect
Retrieve the admin URL for a document previously uploaded via this MCP server. The admin URL grants full control and is equivalent to a password. ONLY call this tool when the user explicitly asks to see, save, or copy the admin URL — for example: 'give me the admin URL', 'save the admin link to my notes', 'what's the owner credential'. DO NOT call this as part of normal upload, share, or collaboration flows; the admin URL should never be surfaced to the user unless directly requested.
Inputs: document_id (required).
get_versionsARead-onlyIdempotentInspect
Get the edit history of a document — who edited, when, and via what. If the document is in this MCP server's local store, 'key' is optional.
Inputs: document_id (required), key.
list_commentsARead-onlyIdempotentInspect
List all comments on a document, including replies and resolution status. If the document is in this MCP server's local store, 'key' is optional.
Inputs: document_id (required), key.
list_linksARead-onlyIdempotentInspect
List all share links for a document, including status (active/revoked), permission, and label. Requires admin access. If the document is in this MCP server's local store, 'key' is optional.
Inputs: document_id (required), key.
list_my_documentsARead-onlyIdempotentInspect
List documents you've previously uploaded via this MCP server on this machine. Returns document_id, title, share_url, share_permission, created_at, and expires_at for each — does NOT return the admin credential. Use this to help the user find and resume older documents without re-pasting admin URLs. Does NOT include documents created via the mdshare web UI or via direct API calls from other clients — only those created by this MCP server. Returns an empty array on a fresh install or after the local store has been cleared.
Inputs: no named parameters.
patch_documentADestructiveInspect
Apply find/replace operations to a document without rewriting the full content. More efficient than update_document for small edits to large documents. Each find string must be unique unless replace_all is set. If the document is in this MCP server's local store, 'key' is optional. PREFER file_path over operations for batches of operations stored in a JSON file on disk — bypasses inline transmission. If both file_path and operations are provided, file_path wins.
Inputs: document_id (required), key, file_path, operations, +1 more.
post_commentAInspect
Post a comment on a document, optionally anchored to specific text. Can also reply to an existing comment. If the document is in this MCP server's local store, 'key' is optional.
Inputs: document_id (required), content (required), key, author_name, +2 more.
read_documentARead-onlyIdempotentInspect
Read a markdown document from mdshare. Returns the content. If the document was uploaded via this MCP server, 'key' is optional — the admin key will be loaded from local storage. PREFER output_path over inline reading for large documents — writes directly to disk and returns a small summary, dramatically faster than echoing content through the conversation.
Inputs: document_id (required), key, output_path.
register_documentAIdempotentInspect
Register an mdshare admin URL you already have saved (in notes, chat history, emails, etc.) so it can be resumed without re-pasting the key every time. Takes an admin URL of the form https://mdshare.live/d/{id}?key=adm..., verifies it against the live API, and stores it in ~/.mdshare-mcp/documents.json. Only accepts admin URLs (adm prefix) — view/comment/edit share links will be rejected. For bulk registration across many files, use the LLM's built-in file reading and search tools to find admin URLs, then call this tool once per URL found.
Inputs: admin_url (required).
resolve_commentADestructiveIdempotentInspect
Resolve or unresolve a comment. Requires edit or admin permission. Key must be provided explicitly because comments are addressed by comment_id — the MCP server can't look up the parent document.
Inputs: comment_id (required), key (required), resolved (required).
revoke_linkADestructiveIdempotentInspect
Revoke a share link, making it permanently inactive. Use list_links first to find the token of the link to revoke. Requires admin access. If the document is in this MCP server's local store, 'key' is optional.
Inputs: document_id (required), link_token (required), key.
update_documentADestructiveInspect
Update the content of an existing mdshare document (full replace). Requires edit or admin permission. If the document is in this MCP server's local store, 'key' is optional. PREFER file_path over content for files already on disk — reads directly from disk without transmitting content through this conversation. If both file_path and content are provided, file_path wins. For small edits to large documents, consider patch_document instead — keeps version history granular.
Inputs: document_id (required), key, file_path, content, +1 more.
upload_markdownAInspect
Upload markdown to mdshare and receive a shareable link. The response contains a read/comment/edit share link (default permission: comment) that the user can share with others. The admin credential (full control) is stored locally in ~/.mdshare-mcp/documents.json and is NOT returned in this response — if the user explicitly asks to see or save the admin URL, call get_admin_url. PREFER file_path over content for files already on disk — reads directly from disk without transmitting content through this conversation, which is dramatically faster for files larger than ~1KB.
Inputs: file_path, content, share_permission.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool has a distinct purpose with no overlap: upload_markdown creates new documents, read_document retrieves content, update_document and patch_document handle edits differently, list_my_documents manages local storage, generate_link/revoke_link/list_links manage sharing, and post_comment/list_comments/resolve_comment handle comments. The descriptions clearly differentiate their functions, preventing agent misselection.
All tools follow a consistent verb_noun naming pattern (e.g., upload_markdown, read_document, list_comments) with no deviations. The pattern is uniform across all 14 tools, making them predictable and easy for an agent to parse and understand.
With 14 tools, the server is well-scoped for managing markdown documents on mdshare, covering upload, read, update, patch, local listing, sharing, and commenting. Each tool serves a specific function without redundancy, making the count appropriate for the domain's complexity and workflows.
The tool set provides comprehensive coverage for document lifecycle (upload, read, update, patch, history via get_versions) and collaboration (sharing, commenting). Minor gaps include no tool for deleting documents or managing user permissions beyond share links, but core workflows are fully supported, allowing agents to work effectively.
Maintenance
Related MCP Connectors
Markdown workspace for AI agents: read, write, organize, and share markdown documents.
Share HTML and Markdown files from AI agents within your company, with versions and comments.
One link any agent can edit: shared docs for people and AI agents, live. No login.
Share HTML/Markdown documents via URL instantly. Create, edit, delete docs from any AI tool.
Related MCP Servers
AlicenseNot gradedqualityDmaintenancePersistent docs and memory for AI agents. Writespace is a collaborative markdown editor with a built-in MCP server — your model reads, writes, organizes, and searches a shared workspace while humans edit the same docs live. Drop the ranked full-text search straight in as RAG retrieval.MIT- AlicenseNot gradedqualityDmaintenanceA local-first markdown review tool with MCP integration, enabling AI and humans to collaboratively annotate documents inline and generate revision prompts.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables sharing Markdown documents for collaborative review with inline annotations and structured change requests.12 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables agents to join multiplayer markdown rooms, collaborate on documents live with humans, and respond to mentions via comments.-