Carve logo

Carve

Parse, validate, format, render, edit, migrate, and inspect Carve documents through MCP tools.

Install Carve

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "carve": {
      "command": "npx",
      "args": [
        "-y",
        "@markup-carve/carve-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 15 tools correctly (Today).

Overview

Carve MCP server exposes the Carve parser, linter, formatter, and renderers to MCP clients. Its tools cover document parsing, diagnostics, formatting, rendering, target checks, AST selection and patching, reviewed edits with undo support, migration, and reference-graph inspection. File access is restricted to configured roots. Use Carve when an agent needs structured tooling for working with Carve documents rather than unrestricted file operations.

Use cases

  • Lint and diagnose Carve documents
  • Format and render Carve source
  • Plan and apply AST-based edits
  • Create reversible document changes
  • Migrate Carve documents and inspect references

Key features

  • Carve parsing and linting
  • Document formatting and rendering
  • AST selection, patching, and planning
  • Reviewed and reversible edits with undo support
  • Target checks and reference-graph inspection
  • Carve document migration

Tools15

What Carve lets your agent do. Expand a tool for its parameters.

Verified live~3.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

10/10 checks healthy over the last 50d

What it can do

From the 15 tools this server returned when we ran it; 15 declare their own safety hints.

Runs commands · 1Read-only tools · 14
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age57 days
Maintainers1

Observed 2026-11-02 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @markup-carve/carve-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.6kPackage downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed15Callable tools this server registers over MCP.

How Carve works

What Carve MCP server does

Carve MCP server brings core Carve document operations into an MCP interface. It can parse documents, report lint results, diagnose and fix issues, format source, render documents, and check targets. The server also exposes structured editing workflows based on the Carve abstract syntax tree (AST), including node selection, block retrieval, source replacement, AST patch creation, patch application, and planned edits.

Editing tools include reviewed and reversible workflows. Agents can create and apply reversible AST patches, perform reviewed edits, and undo reviewed changes with an undo receipt. Migration and reference-graph tools extend the server beyond one-off parsing or formatting tasks, making it suitable for document transformation and relationship inspection.

How it works

The server uses the @markup-carve/carve package and exposes its parser, linter, formatter, and renderers through MCP tools. An MCP client invokes individual operations such as carve_parse, carve_lint, or carve_render; editing operations can work at the AST or source level depending on the requested workflow.

File access is limited to configured roots. This boundary applies to operations that access documents or other files, so the server is intended to work within explicitly allowed locations rather than across an unrestricted filesystem.

The available tool surface includes:

  • Validation and transformation with carve_lint, carve_diagnose_and_fix, carve_format, carve_render, and carve_migrate.
  • Parsing and target inspection with carve_parse, carve_check_targets, and carve_reference_graph.
  • AST navigation and editing with carve_select_ast_nodes, carve_get_block, carve_create_ast_patch, carve_apply_ast_patch, and carve_plan_ast_edit.
  • Source and reversible editing with carve_replace_source, carve_reviewed_edit, carve_undo_reviewed_edit, carve_create_reversible_ast_patch, carve_apply_reversible_ast_patch, and undoReceipt.

Setup and configuration

Install the package globally with npm:

Terminal
npm install -g @markup-carve/carve-mcp

Run the command-line help to inspect the available server options:

sh
carve-mcp --help

The server uses @markup-carve/carve version 0.1.15 or later. Configure the roots that the server may access before using file-based operations. Carve language syntax is covered in the Carve documentation.

Limitations and notes

File access is intentionally restricted to configured roots. The server depends on the Carve package and is designed specifically for Carve documents. Its package is released under the MIT license.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Carve

Carve is an MCP server that connects AI clients to the Carve parser, linter, formatter, and renderers through tools for parsing, validation, formatting, rendering, AST editing, migration, and reference-graph inspection. It also supports reviewed and reversible edits, with file access limited to configured roots.

Install it globally with npm using `npm install -g @markup-carve/carve-mcp`. After installation, run `carve-mcp --help` to inspect the available command-line options.

Yes. Carve provides reviewed and reversible editing tools, including `carve_reviewed_edit`, `carve_undo_reviewed_edit`, `carve_create_reversible_ast_patch`, and `carve_apply_reversible_ast_patch`. File access remains limited to configured roots.

It supports parsing, linting, diagnosis and fixing, formatting, rendering, target checks, AST selection and patching, source replacement, migration, and reference-graph inspection through dedicated MCP tools.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCarve AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/carve?style=directory)](https://allmcps.com/mcp/carve)
HTML Embed
<a href="https://allmcps.com/mcp/carve"><img src="https://allmcps.com/api/badge/carve?style=directory" alt="Carve on AllMCPs" /></a>