Md Log MCP

A Model Context Protocol server - two transports, one tool set - that lets Claude Code (and other agents) save .md files - text and embedded screenshots together - straight into md-log, a human-in-the-loop review & archive layer for vibe coding. The recommended way to connect is the hosted remote endpoint (https://mcp.md-log.com/mcp, a URL +. Its 14 documented tools cover markdown, folder.

People connecting documentation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-27 · ★ 3 · #56 OF 183 MAINTAINED DOCUMENTATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Md Log MCP

before you install - you'll need

Set MDLOG_API_BASE_URL, MDLOG_PAT before connecting.

Claude Code

claude mcp add md-log-md-log-mcp -- npx -y md-log-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "md-log-md-log-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "md-log-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-07-14 - young repo, little track record yet

license MIT - declared in the repository

npm package md-log-mcp - unscoped; check the name against the project README before installing

registry vendor namespace com.md-log - domain-verified with the official MCP registry

03 · What Md Log MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can replace a file's content. Pass expected_version for optimistic concurrency (mismatch → CONFLICT), list a file's immutable version history, newest first (version_no, commit_message, author, registered_at, size), read the full folder tree, and list the documents and immediate subfolders inside a folder path.

Capability map

Tools grouped from the project's README - what Md Log MCP lets an agent do.

Markdown

6 tools - e.g. Append to an existing file with optimistic concurrency (GET current → concat → conditional PUT with base_version_no). Auto-retries once on conflict, then surfac; Replace a file's content. Pass…

append_to_markdown · update_markdown · get_markdown · delete_markdown · search_markdown · move_markdown

Folder

4 tools - e.g. mkdir -p - create every missing segment; already-existing folders count as success.; Move a folder (whole subtree) under a new parent (new_parent_path empty/omitted = root); parent auto-created; cyclic…

create_folder · move_folder · rename_folder · delete_folder

read & search

3 tools - e.g. List a file's immutable version history, newest first (version_no, commit_message, author, registered_at, size).; Return the full folder tree.; List the documents and immediate subfolders inside a folder…

list_versions · list_folders · list_files

create & write

1 tool - e.g. Upload one image (reserve → presigned PUT → complete) and return an asset:// reference to embed as !alt. Provide the image as either data_base64 (inline base64)

upload_asset

04 · Who maintains Md Log MCP

md-log-mcp is maintained by md-log. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

category
documentation - ranked #56 of 183 actively-maintained documentation servers as of 2026-08-25.
registry
com.md-log/md-log-mcp (active, first published 2026-07-14 · 6 versions)
packages
npm:md-log-mcp

06 · Md Log MCP FAQ

Is Md Log MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-27. We re-verify nightly.

What can Md Log MCP do?

With this server connected, an agent can replace a file's content. Pass expected_version for optimistic concurrency (mismatch → CONFLICT), list a file's immutable version history, newest first (version_no, commit_message, author, registered_at, size), read the full folder tree, and list the documents and immediate subfolders inside a folder path.

How do I install Md Log MCP?

Run `npx -y md-log-mcp`. The README documents 2 environment variables (MDLOG_API_BASE_URL, MDLOG_PAT) to set first. Set MDLOG_API_BASE_URL, MDLOG_PAT before connecting. You can also paste the ready-made client config above.

Does Md Log MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Md Log MCP