mkdshare.DEV
by PhilipAnd · remote · no sign-in to list tools · v1.0.0 · published by GitHub user PhilipAnd
Publish and share access-controlled Markdown documents from any MCP-enabled AI tool.
11 tools: 1 can delete or cancel things, 6 change things and 4 only read.
Scanned Oct 21, 2026
- Deletes or cancels1Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things6Claude Code: ask: see these tools
- Only reads4Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http mkdshare https://mkdshare.dev/mcp --header 'Authorization: <your-authorization>'Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
11 tools
Deletes or cancels 1Claude Code: deny
archive_documentArchive a document.No findings
Why it is in this group
- The name "archive_document" says "archive": a word for removing or ending something.
Description, as the server wrote it Archive a document. For documents you own, archives it for everyone. For shared documents, archives it only for you.
Changes things 6Claude Code: ask
create_annotationAdd an annotation (comment) to a document.No findings
Why it is in this group
- The name "create_annotation" says "create": a word for a change.
Description, as the server wrote it Add an annotation (comment) to a document. Pass quoted_text with the exact passage you want to annotate — the server will locate it automatically. Omit quoted_text to attach to the whole document. You can also provide start_offset + end_offset explicitly if needed.
create_documentCreate a new mkdshare.DEV document.No findings
Why it is in this group
- The name "create_document" says "create": a word for a change.
Description, as the server wrote it Create a new mkdshare.DEV document. If visibility is omitted the document is owner-only (login_required, restricted to your email).
poll_device_authCheck whether the user has approved the device authorization.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Check whether the user has approved the device authorization. Call every 5 seconds (or the interval returned by a slow_down response) until status is 'complete'. Save the returned api_token to your MCP server config.
request_device_authStart a headless Google sign-in.No findings
Why it is in this group
- The name "request_device_auth" says "request": a word for a change.
Description, as the server wrote it Start a headless Google sign-in. Call this FIRST if you don't have an API token yet. Returns a user_code and verification_url for the user to visit, plus a device_code to use with poll_device_auth. No Bearer token required.
update_documentUpdate an existing document you own.No findings
Why it is in this group
- The name "update_document" says "update": a word for a change.
Description, as the server wrote it Update an existing document you own. Omit any field to keep its current value.
upload_imageUpload an image (png, jpeg, gif, webp; max 1MB) for embedding in documents.No findings
Why it is in this group
- The name "upload_image" says "upload": a word for a change.
Description, as the server wrote it Upload an image (png, jpeg, gif, webp; max 1MB) for embedding in documents. Returns a URL and a ready-to-paste markdown snippet. Images are served at an unguessable URL — anyone with the exact link can view.
Only reads 4Claude Code: allow
get_documentRead the full markdown content of a document by its slug.No findings
Why it is in this group
- The name "get_document" says "get": a word for reading.
Description, as the server wrote it Read the full markdown content of a document by its slug.
list_annotationsList all annotations (comments) on a document.No findings
Why it is in this group
- The name "list_annotations" says "list": a word for reading.
Description, as the server wrote it List all annotations (comments) on a document.
list_documentsList all mkdshare.DEV documents owned by or shared with the authenticated user.No findings
Why it is in this group
- The name "list_documents" says "list": a word for reading.
Description, as the server wrote it List all mkdshare.DEV documents owned by or shared with the authenticated user.
search_documentsSearch mkdshare.DEV documents by title and content.No findings
Why it is in this group
- The name "search_documents" says "search": a word for reading.
Description, as the server wrote it Search mkdshare.DEV documents by title and content. Returns documents owned by or shared with the authenticated user that match the query.
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.0.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http mkdshare https://mkdshare.dev/mcp --header 'Authorization: <your-authorization>'Run in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__mkdshare__list_documents",
"mcp__mkdshare__get_document",
"mcp__mkdshare__list_annotations",
"mcp__mkdshare__search_documents"
],
"ask": [
"mcp__mkdshare__create_document",
"mcp__mkdshare__update_document",
"mcp__mkdshare__create_annotation",
"mcp__mkdshare__upload_image",
"mcp__mkdshare__request_device_auth",
"mcp__mkdshare__poll_device_auth"
],
"deny": [
"mcp__mkdshare__archive_document"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as mkdshare. Review it before you use it.