RDL MCP Server logo

RDL MCP Server

Edit and inspect SSRS RDL report files through MCP tools for columns, datasets, parameters, formatting, and validation.

Install RDL MCP Server

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

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "rdl-mcp-server": {
      "command": "uvx",
      "args": [
        "rdl-mcp"
      ]
    }
  }
}

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

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx rdl-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 8d ago.

Overview

RDL MCP Server MCP server lets AI assistants inspect and modify SSRS report definition language (RDL) files through focused MCP tools. It exposes report structure, datasets, parameters, and columns as structured data, then applies changes such as column edits, formatting updates, dataset-field changes, and parameter management. The server runs locally through `uvx` and requires Python 3.8 or newer. Reach for it when editing tablix-based SSRS reports through XML would be cumbersome, but note that matrix and chart controls are not supported.

Use cases

  • Inspect an SSRS report’s datasets and parameters
  • Change tablix column headers, widths, and formats
  • Add or remove report columns and dataset fields
  • Update a report’s stored procedure
  • Validate RDL XML after edits

Key features

  • Reads report structure, datasets, parameters, and columns
  • Edits tablix columns and display formats
  • Manages dataset fields and stored procedures
  • Adds and updates report parameters
  • Validates RDL XML
  • Supports filtered and limited dataset-field inspection

Security & health

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

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 30d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 20h ago via OSV.dev · rdl-mcp (PyPI)

Adoption & maintenance

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

GitHub stars13Stargazers on the source repository.
Last commit11mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How RDL MCP Server works

What the RDL MCP Server MCP server does

RDL MCP Server MCP server provides an MCP interface for reading and changing SSRS report definition files. It is designed to keep an AI assistant working with report concepts rather than raw XML namespaces and deeply nested elements. Operations use a file path and report-specific arguments, and return either structured report data or a success/error result.

The server covers common tablix edits. It can inspect a report’s structure, list datasets and their fields, retrieve parameters, and identify column headers, widths, and bindings. Editing operations include changing headers, widths, and display formats; adding or removing columns; changing a dataset’s stored procedure; managing dataset fields; and adding or updating report parameters. XML validation is available after edits.

How it works

The server communicates with an MCP-compatible client over standard input/output. An assistant selects the relevant tool based on a natural-language request, such as finding the datasets in a report or changing a column to a specified width. Each tool accepts a report filepath and operation-specific values, such as a column index, field binding, format string, dataset name, or parameter prompt.

Dataset inspection supports optional field controls. A field limit can return counts only, all fields, or a specified number of fields, while a regular-expression pattern can narrow the returned field names. Column creation can also include an optional width, format, and footer expression, including aggregate expressions such as a sum or count.

Setup and configuration

Install Python 3.8 or later and the uv tool. The documented client configurations start the package with uvx rdl-mcp, so a separate manual package installation is not required. Claude Desktop uses an mcpServers entry with uvx as the command; VS Code uses a stdio server entry and requires the GitHub Copilot Chat extension.

After adding the configuration, restart the MCP client. The server can be run without environment variables. Optional diagnostics are controlled with RDL_MCP_LOG_LEVEL, using DEBUG, INFO, WARNING, or ERROR, and RDL_MCP_LOG_FILE, which specifies a log-file path.

Tools and capabilities

RDL MCP Server MCP server exposes these read operations:

  • describe_rdl_report for a structural report summary.
  • get_rdl_datasets for datasets, fields, and stored procedures.
  • get_rdl_parameters for report parameter configurations.
  • get_rdl_columns for headers, widths, and bindings.

Its editing and checking operations include:

  • Updating headers, widths, and number or date format strings.
  • Adding or removing tablix columns.
  • Changing stored procedures and dataset fields.
  • Adding or updating parameters.
  • Validating the resulting XML structure.

Limitations and notes

The implementation currently targets tablix, or table, controls. Matrix and chart support is not included, and standard report layouts are the best fit. Complex RDL features may still require direct XML editing. The project states that it uses only Python’s standard library and is distributed under the MIT License.

Reviews

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

Frequently Asked Questions about RDL MCP Server

RDL MCP Server is an MCP server that connects AI assistants to SSRS RDL report files. Its main tools read report structure, datasets, parameters, and columns, then modify headers, widths, formats, stored procedures, dataset fields, and parameters, with XML validation available after changes.

Install Python 3.8 or newer and `uv`, then configure your MCP client to run `uvx rdl-mcp`. The documented Claude Desktop and VS Code configurations use this command, so you do not need to install the Python package manually.

Yes, RDL MCP Server works with Claude Desktop through a standard stdio configuration. Add an `rdl-mcp` server entry that runs `uvx` with `rdl-mcp` as its argument, then restart Claude Desktop.

Yes, it works with VS Code when the GitHub Copilot Chat extension is installed. Add a stdio server entry to `.vscode/mcp.json` or user settings, using `uvx` and `rdl-mcp`, then restart the client.

No, it currently targets tablix table controls rather than matrix or chart controls. Complex RDL features may still require manual XML editing, and standard report layouts are the recommended fit.

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 PreviewRDL MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/rdl-mcp-server?style=directory)](https://allmcps.com/mcp/rdl-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/rdl-mcp-server"><img src="https://allmcps.com/api/badge/rdl-mcp-server?style=directory" alt="RDL MCP Server on AllMCPs" /></a>