ROOT-MCP Documentation

ROOT-MCP empowers Large Language Models to natively understand and analyse CERN ROOT files via the Model Context Protocol.

Connect Claude (or any MCP-capable agent) to your ROOT files and ask it to:

• Inspect file structures — Trees, Branches, Histograms

• Analyse distributions — statistics, histograms, fits

• Compute kinematic quantities — invariant mass, 4-vector algebra

• Visualise results — 1D/2D plots returned directly to the chat

pip install root-mcp

# Zero-config start — no YAML required
root-mcp --data-path /path/to/your/data

# Token-efficient CLI for LLM interaction
root-cli -d /path/to/your/data ls

---

User Guide

• Installation
• Quick Start
• Mode Selection
• Configuration
• LLM Integration
• Tool Reference
• ROOT CLI Reference

Developer Guide

• Development Setup
• Module Overview
• Architecture
• Contributing

API Reference

• Package Reference

---

Quick links

Users

• Installation — get up and running in minutes

• Quick Start — zero-config walkthrough and first queries

• Tool Reference — complete tool catalogue

• ROOT CLI Reference — root-cli command reference

• LLM Integration — prompting strategies for Claude and others

Contributors

• Development Setup — clone, install dev deps, run tests

• Module Overview — annotated package tree

• Architecture — three-tier design overview

• Contributing — PR workflow and code style