Md Log MCP server

Read from the package source without running it. The installed server may list more.

• append_to_markdown

  Append content to the end of an existing .md file using optimistic concurrency (GET current -> concat -> PUT with base_version_no). Auto-retries once on conflict, then surfaces CONFLICT.

• create_folderwrite action

  Create a folder path, creating every missing parent segment (mkdir -p). Already-existing folders are treated as success.

• delete_folderwrite action

  Delete a folder. Requires confirm:true (otherwise VALIDATION). By default only an EMPTY folder is deleted (a non-empty one is refused); pass cascade:true to soft-delete the whole subtree \u2014 every subfolder and document under it (like `rm -r`). Documents are soft-deleted (recoverable), but prefer move_folder/move_markdown when reorganizing.

• delete_markdownwrite action

  Soft-delete a .md file. Requires confirm:true (otherwise VALIDATION). Resolves the path to a document key, then DELETE /documents/{key}.

• get_markdown

  Read a .md file's content by path. Pass `version` (a version_no from list_versions) to read an OLD immutable version instead of the current one.

• list_files

  List the documents (and immediate subfolders) inside a folder path. Omit path (or pass '' / '/') to list the ROOT folder.

• list_folders

  Return the full folder tree.

• list_versions

  List a .md file's immutable version history, newest first (version_no, commit_message, author, registered_at, size). Read an old version's content with get_markdown + `version`.

• move_folder

  Move a folder (with its whole subtree: documents, versions, annotations) under a new parent. new_parent_path '' or omitted = move to the root. Parent folders are auto-created. Moving a folder into its own subtree is rejected by the server.

• move_markdown

  Move and/or rename a .md file: from_path -> to_path. Destination folders are auto-created (mkdir -p). The document KEEPS its identity (same document key), so its whole version history and reviewers' annotations survive the move \u2014 never re-save + delete to relocate a file. Fails if a different file already occupies to_path.

• rename_folder

  Rename a folder in place (descendant paths are rewritten automatically; documents, versions and annotations are untouched).

• save_markdown

  Save (create or overwrite) a .md file in md-log by path; missing folders are auto-created. Optionally upload embedded images as assets first and rewrite their refs to asset:// links. This is a force-write (last-writer-wins) \u2014 the headline agent tool. Before choosing a path, PREFER an existing folder that already holds related documents and reuse its exact spelling \u2014 do not invent a new c

• search_markdown

  Search documents by TITLE (substring) and BODY (full-text over current versions; whole-word match, ranked, body hits carry a **bolded** snippet). Use it to find a prior report by its content or name.

• update_markdownwrite action

  Replace the content of an existing .md file. Pass expected_version for optimistic concurrency (mismatch -> CONFLICT); omit it to force last-writer-wins.

• upload_assetwrite action

  Upload a single image as an asset (reserve -> presigned PUT -> complete) and return an 'asset://<key>' reference you can embed in markdown image syntax: . Provide the image as EITHER `data_base64` (inline base64) OR `file_path` (a local file to read) \u2014 exactly one.

• Code scan3 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 22 days ago15/15
• Maintainer identityregistry namespace matches repository owner6/10

Md Log: common questions

Is Md Log MCP server safe?

Mostly: it is graded B (80/100). Read the Md Log safety report

How do I install Md Log?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Md Log need an API key?

Yes. The registry entry asks for MDLOG_PAT.

Is Md Log maintained?

The last commit was 22 days ago (2026-09-03). The latest release is v1.1.4.

What can I use instead of Md Log?

Servers from other publishers that do the same job: Ticket Demo MCP server, HTTP 511 network-auth MCP server and Paxaver MCP server. Compare all Md Log alternatives.