# mdshare
> Free markdown sharing with MCP integration. Upload, get a link, collaborate. No login needed.

## MCP Server
Package: npx mdshare-mcp
Registry: io.github.sathya-sankaran/mdshare
Works with: Claude, ChatGPT/Codex, Gemini CLI, Cursor, Windsurf
Tools: upload_markdown, read_document, update_document, generate_link, list_comments, post_comment, resolve_comment, get_versions

## API
Base URL: https://mdshare.live
Documentation: https://mdshare.live/docs/raw
MCP setup: https://mdshare.live/docs#use-with-ai

## Quick Start
Upload: POST /api/documents (Content-Type: text/markdown, body: raw markdown)
Read: GET /api/d/{id}?key={key} (Accept: text/markdown for raw)
Update: PUT /api/d/{id}?key={edit_key} (Content-Type: text/markdown, X-Author: name)
Links: POST /api/d/{id}/links?key={admin_key} (body: {permission, label, expires_at})
Comments: POST /api/d/{id}/comments?key={key} (body: {content, author_name, anchor_text, parent_id}). Replies nest one level.
Versions: GET /api/d/{id}/versions?key={key}
Presence: POST /api/d/{id}/presence?key={key} (body: {session_id, name})

## Permissions
adm_ = full control | edt_ = read+write | cmt_ = read+comment | viw_ = read only

## Limits
- Documents expire in 90 days (expires_at in create response)
- 10 creates per minute, 50 per day per IP
- 30 updates per minute per IP
- 20 comments per minute per IP
- Max document size: 10MB
- 429 responses include Retry-After header
- Expired documents return 410 Gone