How do I run the MCP server?

Run `npx mdshare-mcp` from an MCP-compatible AI tool.

Can the MCP server read local Markdown files?

Yes. It reads files directly from disk rather than echoing their contents through the conversation.

Which clients are explicitly mentioned?

The README mentions Claude, ChatGPT, Gemini, Cursor, and Windsurf as compatible AI tools; Cursor and Windsurf are also documented with plugins.

What license does the project use?

The project is licensed under MIT.

Mdshare

markdowncollaborationdocument-reviewmcp

Share, review, and sync Markdown documents through permissioned links, comments, and an MCP server.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "urbanmorph-mdshare": {
      "command": "npx",
      "args": [
        "-y",
        "mdshare-mcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This service lets users publish Markdown documents with admin, edit, comment, or view links. It supports inline comments, replies, resolution, real-time WebSocket synchronization, and version history. Its MCP server lets compatible AI tools read local Markdown files, review comments, incorporate feedback, and resolve threads.

Use cases

Share Markdown notes through permissioned links

Review documents with anchored inline comments

Incorporate feedback into Markdown files

Resolve discussion threads with an AI agent

Collaborate on documents with real-time synchronization

Key features

Four permission levels: admin, edit, comment, and view

Inline comments with replies and resolution

Real-time WebSocket synchronization and presence indicators

Share-link revocation, optional expiry, and a 50-link document cap

REST API and MCP server

VS Code and Obsidian plugins

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Mdshare.

Extracted Tool Capabilities

Four permission levels: admin, edit, comment, and view

Inline comments with replies and resolution

Real-time WebSocket synchronization and presence indicators

Share-link revocation, optional expiry, and a 50-link document cap

REST API and MCP server

VS Code and Obsidian plugins

Documentation Overview

mdshare

Share markdown instantly. Free. No login required.

mdshare.live | API Docs | VS Code | Obsidian

mdshare editor

Quick Start

Paste markdown at mdshare.live, start from a blank page, or upload via curl:

Terminal

curl -X POST https://mdshare.live/api/documents \
  -H "Content-Type: text/markdown" \
  --data-binary @your-file.md

You get back an admin URL. Share it, or generate links with different permissions.

Full API documentation

Features

Four permission levels -- Admin, Edit, Comment, View -- each with its own shareable link
WYSIWYG editor -- formatting toolbar, tables, code blocks, keyboard shortcuts
Inline comments -- anchor comments to specific text, reply, and resolve
Real-time sync -- WebSocket collaboration, live presence indicators
Link management -- revoke links instantly, optional expiry, 50-link cap per document
VS Code & Obsidian plugins -- share markdown directly from your editor
API & MCP -- REST API + MCP server for Claude, ChatGPT, Gemini, Cursor, and Windsurf

MCP Server

Terminal

npx mdshare-mcp

Say "upload my-notes.md to mdshare" in any MCP-compatible AI tool. The MCP server reads files directly from disk (no echoing through the conversation), so it's fast even for large markdown files. Setup guide

Claude Code Plugin

Code

/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorph

Wraps the MCP server above with a single skill — Claude reaches for it on phrases like "share this markdown". Setup guide · source

Cursor Plugin

Listed on Cursor Directory — click "Add to Cursor" on the listing page. Same MCP server, same skill as the Claude Code plugin. Source

Obsidian Plugin

Listed in the Obsidian Community Plugins directory — install via Settings → Community Plugins → Browse → search "mdshare". Right-click any .md file in your vault to share it; admin URL is copied to your clipboard. Source

Tech Stack

Component	Technology
Framework	Astro 5
UI	React (as Astro islands)
Hosting	Cloudflare Workers (native)
Database	Cloudflare D1 (SQLite)
Real-time	Cloudflare Durable Objects (WebSocket)
Editor	Tiptap + tiptap-markdown
Styling	Tailwind CSS v4
CI/CD	GitHub Actions

Local Development

bash

git clone https://github.com/urbanmorph/mdshare.git
cd mdshare
npm install

# Create a .dev.vars file with your Cloudflare API token
echo "CLOUDFLARE_API_TOKEN=your_token" > .dev.vars

# Apply local D1 migrations
npx wrangler d1 migrations apply mdshare-db --local

# Start dev server
npm run dev -- -p 3737

Contributing

Issues and PRs welcome. Please open an issue first to discuss significant changes.

License

MIT

Read the full README →View source on GitHub →

Related MCP Servers

View all in Workplace & Productivity View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

264

Package downloads in the last 30 days.

Last commit

1mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Mdshare

No. The service is described as free and requires no login.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/urbanmorph-mdshare?style=directory)](https://allmcps.com/mcp/urbanmorph-mdshare)

HTML Embed

<a href="https://allmcps.com/mcp/urbanmorph-mdshare"><img src="https://allmcps.com/api/badge/urbanmorph-mdshare?style=directory" alt="Mdshare on AllMCPs" /></a>

Technical Specs & Signals

CategoryWorkplace & Productivity

PricingFree

9/10 checks healthy over the last 31d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity7/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 25d ago via OSV.dev · mdshare-mcp (npm)

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🏢 Workplace & Productivity →Best MCP servers for Workplace & Productivity →Alternatives to Mdshare →Install in Claude Desktop Install in Cursor Install in VS Code

Overview

Use cases

Share Markdown notes through permissioned links

Review documents with anchored inline comments

Incorporate feedback into Markdown files

Resolve discussion threads with an AI agent

Collaborate on documents with real-time synchronization

Key features

Four permission levels: admin, edit, comment, and view

Inline comments with replies and resolution

Real-time WebSocket synchronization and presence indicators

Share-link revocation, optional expiry, and a 50-link document cap

REST API and MCP server

VS Code and Obsidian plugins

Documentation Overview

mdshare

Share markdown instantly. Free. No login required.

mdshare.live | API Docs | VS Code | Obsidian

mdshare editor

Quick Start

Paste markdown at mdshare.live, start from a blank page, or upload via curl:

Terminal

curl -X POST https://mdshare.live/api/documents \
  -H "Content-Type: text/markdown" \
  --data-binary @your-file.md

You get back an admin URL. Share it, or generate links with different permissions.

Full API documentation

Features

Four permission levels -- Admin, Edit, Comment, View -- each with its own shareable link
WYSIWYG editor -- formatting toolbar, tables, code blocks, keyboard shortcuts
Inline comments -- anchor comments to specific text, reply, and resolve
Real-time sync -- WebSocket collaboration, live presence indicators
Link management -- revoke links instantly, optional expiry, 50-link cap per document
VS Code & Obsidian plugins -- share markdown directly from your editor
API & MCP -- REST API + MCP server for Claude, ChatGPT, Gemini, Cursor, and Windsurf

MCP Server

Terminal

npx mdshare-mcp

Claude Code Plugin

Code

/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorph

Wraps the MCP server above with a single skill — Claude reaches for it on phrases like "share this markdown". Setup guide · source

Cursor Plugin

Listed on Cursor Directory — click "Add to Cursor" on the listing page. Same MCP server, same skill as the Claude Code plugin. Source

Obsidian Plugin

Tech Stack

Component	Technology
Framework	Astro 5
UI	React (as Astro islands)
Hosting	Cloudflare Workers (native)
Database	Cloudflare D1 (SQLite)
Real-time	Cloudflare Durable Objects (WebSocket)
Editor	Tiptap + tiptap-markdown
Styling	Tailwind CSS v4
CI/CD	GitHub Actions

Local Development

bash

git clone https://github.com/urbanmorph/mdshare.git
cd mdshare
npm install

# Create a .dev.vars file with your Cloudflare API token
echo "CLOUDFLARE_API_TOKEN=your_token" > .dev.vars

# Apply local D1 migrations
npx wrangler d1 migrations apply mdshare-db --local

# Start dev server
npm run dev -- -p 3737

Contributing

Issues and PRs welcome. Please open an issue first to discuss significant changes.

License

MIT

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

264

Package downloads in the last 30 days.

Last commit

1mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.