Skip to content
MCP server

Sezzlee XML

Query local XML with XPath, tabular projection and grouped totals, from one folder

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.5.1
Listing updated
2 days ago

About Sezzlee XML

Sezzlee XML is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Rather than dumping a large XML file into the model's context, this server lets the agent ask for answers. describe_document first reports the document element, every namespace with a stable alias and which elements repeat, so the agent can name the repeating record once. project_records then turns that element into rows and named columns, and each cell says whether its value was present, empty, missing or found more than once. aggregate_document groups by a column and counts or, in binary64 numeric mode, sums and averages.

In the quickstart, an orders file in two namespaces is asked how much was paid per status and comes back as three lines instead of six records; on a fifty-thousand-record file the answer stays the same size. A cancelled order with no payment shows a total of 0 with counted: 0, which differs from a payment of zero.

select_xpath runs one XPath 1.0 expression with a typed result, read_node returns a bounded slice of the tree and find_in_document searches text and attributes. Files over an 8 MiB ceiling switch to a reduced chunked mode where XPath, search and aggregation are unavailable. It reads .xml, .xsd, .xhtml, .svg, .csproj, .props, .targets, .config and .resx.

Install

Run in a terminal

claude mcp add xml -- npx -y @sezzlee/xml-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "xml": {
      "command": "npx",
      "args": [
        "-y",
        "@sezzlee/xml-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "xml": {
      "command": "npx",
      "args": [
        "-y",
        "@sezzlee/xml-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "xml": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sezzlee/xml-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xml": {
      "command": "npx",
      "args": [
        "-y",
        "@sezzlee/xml-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "xml": {
      "command": "npx",
      "args": [
        "-y",
        "@sezzlee/xml-mcp"
      ]
    }
  }
}

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

list_documents
List readable XML documents
describe_document
Document element, namespaces and repeated-element candidates
read_node
Bounded slice of the tree
find_in_document
Literal text search in text nodes or attributes
select_xpath
Run one XPath 1.0 expression
project_records
Repeated element as rows and columns
aggregate_document
Counts, distinct counts, sums and averages per group

What it does

XPath 1.0 queries
select_xpath evaluates one expression exactly as written and returns a typed result.
Records as rows
project_records turns a repeated element into named columns with a status per cell.
Grouped aggregates
aggregate_document counts, counts distinct values and, in binary64 mode, sums and averages.
Namespace aliases
describe_document gives every namespace a stable alias for use in later calls.
Bounded tree reads
read_node returns an ordered slice of the tree rather than the whole file.
Folder sandbox
Only one folder is readable and no tool writes.

Good for

  • Total payments per order status in an XML export
  • Inspect the structure of an unfamiliar XML feed
  • Pull a repeated element into a table
  • Search a .resx or .csproj file for a literal value

Pricing

Open source

Free; part of the MIT-licensed Sezzlee MCP repository

Prices change. Check docs.sezzlee.app before you buy.

Sezzlee XML FAQ

Does it modify XML files?

No. It is read-only and has no write tool.

What happens with very large files?

Over an 8 MiB resident ceiling a document is read in chunked mode, where project_records still works but XPath, search and aggregation do not.

Which platforms are supported?

Node.js 22 or 24 on macOS (x64, arm64), glibc Linux (x64, arm64) and Windows x64; Alpine is not supported.

Is a .config file always XML?

No. Such files are only candidates, so a parse error there is expected.

Is Sezzlee XML free?

Yes. Sezzlee XML is open source, so you can use and self-host it for free.

How do I add Sezzlee XML to Claude Code?

Run this command in your terminal: claude mcp add xml -- npx -y @sezzlee/xml-mcp

What are the best alternatives to Sezzlee XML?

The closest alternatives to Sezzlee XML are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Sezzlee XML

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools