# Sezzlee XML

> Sezzlee XML is an open-source MCP server for files and documents. Query local XML with XPath, tabular projection and grouped totals, from one folder. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://docs.sezzlee.app/docs/xml-mcp/quickstart
- **Repository:** https://github.com/sezzlee/mcp/tree/HEAD/packages/servers/xml-mcp
- **MCP Registry name:** io.github.sezzlee/xml
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/sezzlee-xml
