Assembly for .NET Assembly for Java Assembly for Node.js Assembly for Python via .NET
Assembly for AI Agents (MCP)

Document generation from templates for AI agents via MCP server

Ask Claude, Cursor or Copilot to turn an order into a contract, a customer list into one letter each, or a spreadsheet into a report with tables and charts. The agent supplies the data, the template controls the document, and nothing is uploaded.
NuGet Download Start Free Trial
One-click install: VS CodeCursorAll clients
Version 26.11.0  released
See what’s new

Generate a contract from a template with an AI agent

More examples >
{
  "mcpServers": {
    "groupdocs-assembly": {
      "command": "dnx",
      "args": ["GroupDocs.Assembly.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}
Then ask: Fill contract-template.docx with this order and save it as a PDF
dnx GroupDocs.Assembly.Mcp --yes

GroupDocs.Assembly MCP server at a glance

An MCP server that gives AI agents the GroupDocs.Assembly engine as tools they can call

Illustration assembly

The model fills in the data, the template writes the document

The agent asks the template which fields it needs, builds the data from your request or your files, and GroupDocs.Assembly renders the tables, charts, images and barcodes the template defines. The layout never depends on what the model improvises.

Local by design

Your AI client starts the server as a local process over stdio. It opens no ports, sends no telemetry, and reads and writes only the folder you configure, so contracts, records and internal documents never leave your machine.

Works with every MCP client

Use it from Claude Desktop, Claude Code, VS Code with GitHub Copilot, Visual Studio 2022, Cursor, Windsurf, Cline, JetBrains Rider and Codex CLI. One-click installs and ready-made configurations are available for each client.

Runs where your agent runs

GroupDocs.Assembly MCP server works on Windows, Linux and macOS, natively with .NET 10 or in Docker

VS Code
Docker
NuGet
Windows
Linux
macOS
Azure
Amazon

NuGet package

  • One command with the .NET 10 SDK, no install step
  • Windows, Linux and macOS
NuGet download

Docker image

  • Nothing to install besides Docker
  • linux/amd64 and linux/arm64, native dependencies bundled
Get the image

VS Code and GitHub Copilot

  • One-click install with a pre-filled configuration
  • Set your documents folder after install
Install in VS Code

Cursor

  • One-click install with a pre-filled configuration
  • Runs in evaluation mode until you add a license
Add to Cursor

Supported file formats

GroupDocs.Assembly MCP server works with the following file formats.

Microsoft Office formats

  • Word: DOCX, DOC, DOCM, DOT, DOTX, DOTM, RTF, WordprocessingML
  • Excel: XLSX, XLS, XLSM, XLSB, XLTM, XLT, XLTM, XLTX, SpreadsheetML
  • PowerPoint: PPT, PPTX, PPTM, PPS, PPSX, PPSM, POTM, POTX

Images & Other Formats

  • Portable: PDF
  • Images: SVG, TIFF
  • Other office formats: ODT, OTT, OTS, ODS, ODP, OTP

Other formats

  • Web: HTML, MHTML
  • Emails: EML, MSG, EMLX
  • Other: EPUB, MD

What the MCP server can do

Fill Word, Excel, PowerPoint, Markdown and e-mail templates with JSON, XML, CSV or spreadsheet data

Feature icon

Template plus data

The assemble_document tool fills a template with inline JSON or a data file and saves DOCX, XLSX, PPTX, PDF, HTML or e-mail.

Feature icon

One document per record

The assemble_per_record tool writes a letter, certificate or invoice for every record, named by a field you choose.

Feature icon

Tables, charts and barcodes

Repeating rows, charts, images and barcodes come from the template; the data only supplies the values.

Feature icon

JSON, XML, CSV and spreadsheets

Read data from JSON, XML, CSV and TSV files, or from a table in a workbook, Word or PowerPoint document.

Feature icon

Ask the template

The get_template_fields tool lists every tag and returns a JSON skeleton of the data the template expects, without generating anything.

Feature icon

Many output formats

Save the result in the template format or as PDF, HTML, Markdown and more.

Feature icon

Clear error messages

A missing field or an unclosed block is named in the error, or written next to the tag with inline error mode.

Feature icon

Markdown and text templates

Templates can be Word, Excel and PowerPoint files, Markdown, HTML, plain text or e-mail.

Feature icon

Flexible licensing

Start in evaluation mode, then use a license file or metered keys. The get_license_status tool shows which one is active.

What you can ask your agent

Typical GroupDocs.Assembly MCP scenarios, each with the prompt that drives it

One letter per customer

The agent fills the template once per record, names each file after a field and lists the records that failed instead of stopping. Step by step: guide and blog walkthrough.

Prompt

Create a welcome letter for every customer in customers.json
with welcome-letter.docx, one PDF each, named after the customer

A report with a chart from a spreadsheet

The template defines the table and the chart; the agent points it at the data, and the numbers fill both. Step by step: guide and blog walkthrough.

Prompt

Build the regional sales report from sales.xlsx
with sales-report.docx and save it as a PDF

Ask what a template needs

Before generating, the agent asks the template for its fields and gets a JSON skeleton to fill. When a run fails, the error names the missing field. Step by step: guide and blog walkthrough.

Prompt

What data does contract-template.docx need?
Show me the fields and an example to fill in

Run on-premise with Docker

For regulated environments, run the server inside your perimeter. Mount the documents folder and the license, and pin the image version for change control. Architecture and security model: on-premise deployment.

docker-compose.yml

services:
  groupdocs-assembly:
    image: ghcr.io/groupdocs-assembly/assembly-net-mcp:26.11.0
    volumes:
      - "/srv/documents:/data"
      - "/srv/licenses:/license:ro"
    environment:
      GROUPDOCS_MCP_STORAGE_PATH: /data
      GROUPDOCS_LICENSE_PATH: /license/GroupDocs.Total.lic
    stdin_open: true

Install in your AI client

Copy the configuration for your client, or use the one-click links at the top of the page

Register the server

Every client starts the server the same way. Set GROUPDOCS_MCP_STORAGE_PATH to the folder with your documents, then restart the client. Leave GROUPDOCS_LICENSE_PATH empty for evaluation mode. Configurations for Visual Studio 2022, Windsurf, Cline, JetBrains Rider and Codex CLI are in the installation guide.
Claude Desktop Claude Code VS Code Cursor Docker
{
  "mcpServers": {
    "groupdocs-assembly": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Assembly.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}

claude mcp add groupdocs-assembly \
  -e GROUPDOCS_MCP_STORAGE_PATH=/path/to/documents \
  -- dnx GroupDocs.Assembly.Mcp --yes

{
  "servers": {
    "groupdocs-assembly": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Assembly.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}

{
  "mcpServers": {
    "groupdocs-assembly": {
      "command": "dnx",
      "args": ["GroupDocs.Assembly.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}

docker run --rm -i \
  -v /path/to/documents:/data \
  ghcr.io/groupdocs-assembly/assembly-net-mcp:latest

Ready to get started?

Download GroupDocs.Assembly for free or get a trial license for full access!

Useful resources

Explore documentation, code samples, and community support to enhance your experience.

Documentation
API reference
Code samples
Free support
Paid support

Temporary license tips

1
Sign up with your work email.
Free mail services are not allowed.
2
Use Get a temporary license button on the second step.
Go to license
✕