MCP Server

Overview

Use the ActiveReports.NET MCP Server to help your AI agent answer product questions and complete development tasks with official ActiveReports.NET guidance.

The Model Context Protocol (MCP) lets an AI agent connect to external sources of information and tools. The ActiveReports.NET MCP Server gives the agent product-specific context when you ask for guidance or assign a development task.

This context helps the agent distinguish between ActiveReports.NET report types, designers, viewers, application platforms, data providers, exports, and deployment requirements. The agent can use this knowledge to explain a feature, recommend an approach, or make applicable changes in your project. It also helps prevent the agent from using ActiveReportsJS guidance in an ActiveReports.NET project.

What the MCP Server Provides

The ActiveReports.NET MCP Server helps an AI agent:

• find relevant ActiveReports.NET documentation and implementation guidance.

• identify the correct report type and design or runtime surface for a task.

• select applicable NuGet packages and application setup steps.

• find guidance for viewers, designers, data providers, licensing, and exports.

• use current product APIs and recommended implementation patterns.

• diagnose product-specific errors with relevant documentation.

Set Up the MCP Server

Before you use the ActiveReports.NET MCP Server, connect it to an AI client that supports MCP.

Use the main MESCIUS MCP documentation to:

1. Get a product-specific MCP token.

2. Configure your AI client with the ActiveReports.NET endpoint and token.

3. Verify the connection.

If the connection does not work, see MCP troubleshooting.

Get ActiveReports.NET Guidance

Ask your AI agent a product-specific question when you need an explanation, recommendation, or troubleshooting guidance. Include the ActiveReports.NET version, application type, report type, and target surface when they are relevant.

For example:

Use the ActiveReports.NET MCP Server to explain the differences between Page,
RDLX, and Section reports. Recommend a report type for a fixed-layout invoice
that must export to PDF.

Use the ActiveReports.NET MCP Server to compare the available viewers for a
Blazor application. Explain the required client and backend components for each
applicable option.

Use the ActiveReports.NET MCP Server to explain why this PDF export error occurs
and recommend a solution. The report is an RDLX report in an ASP.NET Core
application. Here is the full error message: <paste error message>.

Complete ActiveReports.NET Tasks

You can also ask the agent to complete an ActiveReports.NET development task. Describe the required result and identify the project, report type, application surface, or output that the agent must change.

For example:

Use the ActiveReports.NET MCP Server to add the ActiveReports.NET Viewer to this
Blazor application. Install the applicable packages, configure the required
backend services, update the application, and verify that the project builds.

Use the ActiveReports.NET MCP Server to add PDF export for the RDLX invoice in
this ASP.NET Core application. Update the required package references and code,
then build the project and report any remaining requirements.

Use the ActiveReports.NET MCP Server to diagnose and fix this report error.
Inspect the project, use the applicable ActiveReports.NET guidance, make the
required changes, and verify the result. Error: <paste error message>.

The MCP Server supplies ActiveReports.NET product information. The AI agent uses its available editor, file, terminal, and other tools to perform the work.

Review all generated code, configuration, and project changes before you use them in production.

Use the MCP Server with the Report Builder CLI

The MCP Server provides product information and guidance. It does not create or change local report files by itself.

For local Page and RDLX report authoring, ask an AI agent to use both tools. The agent can use the MCP Server for ActiveReports.NET guidance and the Report Builder CLI to create, modify, validate, and preview the .rdlx file.

For example:

Use the ActiveReports.NET MCP Server and Report Builder CLI to create an RDLX
sales summary at C:\Reports\SalesSummary.rdlx. Use C:\Data\Sales.csv as the
data source. Add a monthly sales chart, a detail table, and a grand total.
Validate the report and create a PNG preview in C:\Reports\Preview.

See Report Builder CLI for setup and report-authoring examples.

Usage Tips

• State whether you want guidance, a project change, or both.

• Give the agent one clear ActiveReports.NET question or task at a time.

• Include the product version when an API or setup can vary by release.

• Identify Page/RDLX, RDLX Dashboard, or Section/RPX when you know the report type.

• Identify the target designer, viewer, application framework, or export format.

• Include the complete error message when you ask for troubleshooting help.

• Give the agent access to the applicable project and approve required actions.

• Start a new conversation if earlier context causes unrelated answers.

See Also

AI Agent Tools

AI Agent Tools

Report Builder CLI

Report Builder CLI

Report Types

Report Types