Home / MCP Server

MCP Server

wikidown-mcp is a stdio MCP server that exposes the Wikidown CLI surface to Claude Code, Claude Desktop, VS Code (Copilot), or any other MCP host.

Install

dotnet tool install -g Wikidown.Mcp

To update an existing install, see Updating — a plain push to main doesn't always mean a new NuGet version is available.

No .NET?

Unlike the CLI, the MCP server currently ships only as a NuGet global tool, so it needs the .NET SDK or runtime on PATH — there is no self-contained wikidown-mcp binary yet.

That's less limiting than it sounds: the CLI does ship self-contained, and the shared agent skill tells agents to fall back to wikidown CLI commands whenever the wiki_* MCP tools aren't available. So on a machine without .NET:

curl -fsSL https://wikidown.org/install.sh | sh

irm https://wikidown.org/install.ps1 | iex

installs a self-contained wikidown binary (see CLI § Quick install), and agents keep maintaining the wiki through the CLI fallback — only the MCP wiring (.mcp.json, .vscode/mcp.json) stays dormant until .NET is installed.

Wiki root

Selected in this order:

--root <path> flag
WIKIDOWN_ROOT environment variable
Default ./docs

Tools

wiki_list — list children of a page or the root
wiki_read — read a page
wiki_write — overwrite a page. Auto-injects or refreshes the page's breadcrumb navigation line — see Format § Breadcrumb Navigation.
wiki_new — create a new page
wiki_move — rename or move a page (with subpages). Rewrites inbound links from every other page that pointed at the old path, rewrites the moved page's own relative links and images if the move changed its folder depth, regenerates the breadcrumb for the moved page and every moved descendant, and reports a count and a per-link list of what changed.
wiki_delete — delete a page (optionally recursive)
wiki_reorder — rewrite a folder's .order
wiki_search — search page bodies
wiki_walk — depth-first walk of every page

There's no wiki_check_links tool yet — run wikidown check-links from the CLI (see CLI) to validate that relative links/images resolve and that page bodies don't contain absolute title-path links, which 404 when a page is viewed directly on github.com.

Wiring it in

Sample configs for Claude Code (.mcp.json) and Claude Desktop live in samples/mcp/ in the repo. AI agents should prefer these tools over raw file edits so .order files and internal links stay consistent.