Carve MCP server

Carve MCP server

Give MCP-compatible assistants the same Carve parser, linter, formatter, and renderers used by the JavaScript implementation. Filesystem access is absent by default and can be enabled for explicitly configured document roots.

Tools

position-independent patch.

• carve_lint checks a document and returns precise, structured warnings.
• carvediagnoseand_fix previews safe fixes, applies selected fix IDs, and returns an undo patch; ambiguous repairs remain writer-review items.
• carve_format produces canonical Carve and reports rendering losses.
• carve_render renders HTML, Markdown, plain text, or ANSI.
• carvechecktargets compares publishing compatibility across HTML, Markdown, plain text, ANSI, GitHub, WordPress, and PDF-stage profiles.
• carve_parse returns the resolved, position-aware interchange AST.
• carvecreateast_patch compares two interchange ASTs and returns a

canonical Carve source without changing files.

• carveapplyast_patch validates and previews a patch as both an AST and

AST path without making an ambiguous selection for the caller.

• carveselectast_nodes finds headings, footnotes, node types, or a current

intents into one explained, reversible source patch for approval.

• carveplanast_edit turns one or more exact semantic matches and small edit

stale-edit fingerprints.

• carvecreatereversibleastpatch adds inverse operations and semantic

as a guarded UTF-8 source edit.

• carveapplyreversibleastpatch safely previews forward or undo operations

• carve_migrate converts HTML, Markdown, Djot, or BBCode and reports version 2 migration fidelity.
• carvereferencegraph indexes cross-document headings, footnotes, abbreviations, links, and images, including broken edges and orphaned definitions (when workspace access is enabled).

Tools return concise text for readers alongside schema-validated structured results for clients. Six optional prompts guide common review, conversion, and publishing workflows without replacing the writer's judgment.

Use --tool-profile review, convert, structure, or workspace to expose only the tools needed for that job and reduce model context. The default all profile preserves the complete tool surface.

Raw HTML passthrough is disabled by default because MCP inputs are untrusted. The server has no filesystem access unless you explicitly give it a workspace root. That also governs {{ path }} includes, which stay literal until a call names a configured root. See Include expansion.

Resources

carve://rules/CARVE-P0-001.

• carve://guide is a concise authoring quick start.
• carve://rules explains the normative rule categories.
• carve://rules/{ruleId} looks up a stable normative CARVE-* rule ID, such as

carve_lint.

• carve://lint-rules/{ruleName} explains a stable diagnostic name returned by

The resources identify the Carve version and link to the complete documentation when a reader needs normative detail. Lint diagnostic names are a separate namespace and are returned with their explanations directly by carve_lint.

Get started

Node.js 20 or newer is required.

npx -y @markup-carve/carve-mcp

See Connect Carve to your writing tool for copy-ready setup in Claude, VS Code, Cursor, Zed, and Codex, plus prompts to confirm it works. The compatibility page explains what CI verifies and provides the short host smoke test used for releases.

Shortened. The full README is on GitHub.