Skip to content

Commit 6ac449c

Browse files
GROUPDOCSNET-70 GroupDocs.Conversion docs: split MCP section per platform + document metered licensing
1 parent 08185df commit 6ac449c

14 files changed

Lines changed: 139 additions & 48 deletions

‎_index.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -215,7 +215,7 @@ Elevate your C#, ASP.NET, and other .NET applications with the premier file conv
215215
<div class="gdoc-platform">
216216
<a id="conversion_mcp"></a>
217217
<div class="gdoc-platform__header">
218-
<svg class="gdoc-platform__header-icon"><use xlink:href="/img/groupdocs-stack.svg#net"></use></svg>
218+
<svg class="gdoc-platform__header-icon" viewBox="0 0 24 24" fill="currentColor" role="img" aria-label="Model Context Protocol"><path d="M13.85 0a4.16 4.16 0 0 0-2.95 1.217L1.456 10.66a.835.835 0 0 0 0 1.18.835.835 0 0 0 1.18 0l9.442-9.442a2.49 2.49 0 0 1 3.541 0 2.49 2.49 0 0 1 0 3.541L8.59 12.97l-.1.1a.835.835 0 0 0 0 1.18.835.835 0 0 0 1.18 0l.1-.098 7.03-7.034a2.49 2.49 0 0 1 3.542 0l.049.05a2.49 2.49 0 0 1 0 3.54l-8.54 8.54a1.96 1.96 0 0 0 0 2.755l1.753 1.753a.835.835 0 0 0 1.18 0 .835.835 0 0 0 0-1.18l-1.753-1.753a.266.266 0 0 1 0-.394l8.54-8.54a4.185 4.185 0 0 0 0-5.9l-.05-.05a4.16 4.16 0 0 0-2.95-1.218c-.2 0-.401.02-.6.048a4.17 4.17 0 0 0-1.17-3.552A4.16 4.16 0 0 0 13.85 0m0 3.333a.84.84 0 0 0-.59.245L6.275 10.56a4.186 4.186 0 0 0 0 5.902 4.186 4.186 0 0 0 5.902 0L19.16 9.48a.835.835 0 0 0 0-1.18.835.835 0 0 0-1.18 0l-6.985 6.984a2.49 2.49 0 0 1-3.54 0 2.49 2.49 0 0 1 0-3.54l6.983-6.985a.835.835 0 0 0 0-1.18.84.84 0 0 0-.59-.245"/></svg>
219219
<a class="gdoc-platform__header-title" href='/conversion/mcp/'>GroupDocs.Conversion MCP Server (AI Agents)</a>
220220
<a class="gdoc-platform__header-btn" href='/conversion/mcp/'>More</a>
221221
</div>
@@ -227,9 +227,9 @@ Elevate your C#, ASP.NET, and other .NET applications with the premier file conv
227227
<div class="gdoc-platform__col-descr">Convert documents with Claude, Cursor, and Copilot — locally</div>
228228
<ul class="gdoc-platform__col-links">
229229
<li> <a href='/conversion/mcp/getting-started/'>Quick start</a></li>
230-
<li> <a href='/conversion/net/mcp/install-in-ai-clients/'>Register in AI clients</a></li>
230+
<li> <a href='/conversion/net/mcp/'>Install for .NET</a></li>
231231
<li> <a href='/conversion/mcp/getting-started/licensing/'>Licensing</a></li>
232-
<li> <a href='/conversion/net/mcp/system-requirements/'>System requirements</a></li>
232+
<li> <a href='/conversion/mcp/troubleshooting-faq/'>Troubleshooting &amp; FAQ</a></li>
233233
</ul>
234234
</div>
235235
<div class="gdoc-platform__col">

‎mcp/_index.md‎

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,28 @@ hideChildren: True
1010
toc: True
1111
---
1212

13-
**GroupDocs.Conversion MCP server** lets AI agents like Claude, Cursor, and Copilot convert documents between 100+ formats — PDF, Word, Excel, PowerPoint, images, Markdown — **locally on your machine**. Files are never uploaded to any cloud service. Install with one command:
13+
**GroupDocs.Conversion MCP server** lets AI agents like Claude, Cursor, and Copilot convert documents between 100+ formats — PDF, Word, Excel, PowerPoint, images, Markdown — **locally on your machine**. Files are never uploaded to any cloud service.
14+
15+
Run it with one command. The Docker image is self-contained — the runtime and every native dependency the engine needs are inside it:
16+
17+
```bash
18+
docker run --rm -i -v $(pwd)/documents:/data \
19+
ghcr.io/groupdocs-conversion/conversion-net-mcp:latest
20+
```
21+
22+
With the .NET 10 SDK installed, the same server also runs without Docker:
1423

1524
```bash
1625
dnx GroupDocs.Conversion.Mcp --yes
1726
```
1827

19-
That command is the **.NET** build (`dnx` ships with the .NET 10 SDK); it runs on Windows, Linux, and macOS alike. Other platforms will each get their own one-command launcher — see [Install for your platform](#install-for-your-platform).
28+
Both are the **.NET** build of the server and run on Windows, Linux, and macOS. Other platforms will each get their own launcher — see [Install for your platform](#install-for-your-platform).
2029

2130
Or use the [guided installer]({{< ref "conversion/mcp/getting-started/_index.md" >}}) to register the server in your AI client, verify the setup, and configure shared folders in one pass.
2231

2332
## What you can do
2433

25-
The server exposes four tools to any MCP-compatible agent (full details in the [tools reference]({{< ref "conversion/mcp/tools-reference/_index.md" >}})):
34+
The server exposes these tools to any MCP-compatible agent (full details in the [tools reference]({{< ref "conversion/mcp/tools-reference/_index.md" >}})):
2635

2736
* **`convert`** — convert a document to another format (PDF, DOCX, XLSX, PPTX, HTML, PNG, JPG, Markdown, and many more) and save it to your storage folder.
2837
* **`get_supported_formats`** — list every target format a given document can be converted to.
@@ -38,9 +47,9 @@ Installation, prerequisites, and client configuration are platform-specific; the
3847
| Platform | Status | Install and setup |
3948
|---|---|---|
4049
| .NET | **Available** | [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}) |
41-
| Java | Planned | — |
42-
| Python | Planned | — |
43-
| Node.js | Planned | — |
50+
| Java | Planned | [Tell us you need it](https://forum.groupdocs.com/c/conversion/11) |
51+
| Python | Planned | [Tell us you need it](https://forum.groupdocs.com/c/conversion/11) |
52+
| Node.js | Planned | [Tell us you need it](https://forum.groupdocs.com/c/conversion/11) |
4453

4554
## Conversion vs extraction
4655

‎mcp/getting-started/_index.md‎

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,9 +20,12 @@ Install and register the GroupDocs.Conversion MCP server in Claude Desktop, VS C
2020
git clone https://github.com/groupdocs/GroupDocs.Mcp.Installer.git
2121
cd GroupDocs.Mcp.Installer
2222
23-
./install-groupdocs-mcp.ps1 -Interactive # wizard: products, channel, clients, folders, license
24-
./install-groupdocs-mcp.ps1 -DryRun # preview - prints everything, changes nothing
25-
./install-groupdocs-mcp.ps1 -Verify # apply + warm caches + verify the setup in one go
23+
# wizard: products, channel, clients, folders, license
24+
./install-groupdocs-mcp.ps1 -Interactive
25+
# preview - prints everything, changes nothing
26+
./install-groupdocs-mcp.ps1 -DryRun
27+
# apply + warm caches + verify the setup in one go
28+
./install-groupdocs-mcp.ps1 -Verify
2629
```
2730

2831
Then **restart your AI client** (Claude Desktop, VS Code, Cursor, …) so it picks up the new server.

‎mcp/use-cases/_index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: "Step-by-step scenarios for converting documents with AI agents ove
77
keywords: MCP document conversion use cases, convert documents with AI examples, Claude document conversion scenarios
88
productName: GroupDocs.Conversion MCP Server
99
hideChildren: True
10-
toc: True
10+
toc: False
1111
---
1212

1313
Step-by-step scenarios for converting documents with AI agents over MCP — each page answers one real question completely, with the config, the exact prompt, and the expected result:

‎mcp/use-cases/batch-convert-folder.md‎

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,24 @@
22
id: mcp-batch-convert-folder
33
url: conversion/mcp/use-cases/batch-convert-folder
44
title: How to batch-convert a folder of documents with an AI agent
5+
linkTitle: Batch-convert a folder
56
weight: 4
67
description: "Convert an entire folder of documents with a single prompt — the agent orchestrates, the GroupDocs engine batch-converts locally; nothing is uploaded, originals are kept."
78
keywords: batch convert files with Claude, convert entire folder AI agent, bulk document conversion MCP, batch processing MCP server
89
productName: GroupDocs.Conversion MCP Server
910
toc: True
11+
structuredData:
12+
showOrganization: True
13+
howTo:
14+
name: "How to batch-convert a folder of documents with an AI agent"
15+
description: "Convert an entire folder of documents with a single prompt — the agent orchestrates, the GroupDocs engine batch-converts locally; nothing is uploaded, originals are kept."
16+
steps:
17+
- name: "Install the server"
18+
text: "Run the GroupDocs.Conversion MCP server with Docker or dnx and register it in your AI client."
19+
- name: "Put the documents in the storage folder"
20+
text: "Point GROUPDOCS_MCP_STORAGE_PATH at the folder that holds the files the agent should use."
21+
- name: "Ask the agent"
22+
text: "Convert every DOCX in my documents folder to PDF, keep the originals"
1023
---
1124

1225
Convert an **entire folder of documents with a single prompt** — the agent orchestrates, the GroupDocs engine batch-converts locally; nothing is uploaded and your originals are kept. Point the server at the folder and ask:
@@ -15,6 +28,10 @@ Convert an **entire folder of documents with a single prompt** — the agent orc
1528
1629
The agent enumerates the files, calls [`convert`]({{< ref "conversion/mcp/tools-reference/convert.md" >}}) per document, and reports what it produced. No uploads, no per-file clicking, no script to maintain.
1730

31+
{{< alert style="info" >}}
32+
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
33+
{{< /alert >}}
34+
1835
## The key setting: the storage folder
1936

2037
Batch scenarios live or die on the folder mapping. Set it once and the whole folder is in scope for every prompt:
@@ -35,10 +52,6 @@ Batch scenarios live or die on the folder mapping. Set it once and the whole fol
3552
}
3653
```
3754

38-
{{< alert style="info" >}}
39-
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
40-
{{< /alert >}}
41-
4255
With a separate `GROUPDOCS_MCP_OUTPUT_PATH`, originals stay untouched in storage and every converted file lands in the output folder — the cleanest batch layout. (Installer users: this is `storagePath` / `outputPath` in [one config]({{< ref "conversion/net/mcp/configuration.md" >}}).)
4356

4457
## Prompts that scale

‎mcp/use-cases/convert-documents-with-ai-agents.md‎

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,24 @@
22
id: mcp-convert-documents-with-ai-agents
33
url: conversion/mcp/use-cases/convert-documents-with-ai-agents
44
title: How to convert documents with AI agents using MCP
5+
linkTitle: Convert with AI agents
56
weight: 1
67
description: "Use any MCP-compatible AI agent to convert documents between PDF, Word, Excel, PowerPoint, Markdown, and 100+ other formats — this guide shows the pattern once and links every specific scenario."
78
keywords: how to convert documents with AI, MCP for documents, AI agent convert docx to pdf, convert files with Claude
89
productName: GroupDocs.Conversion MCP Server
910
toc: True
11+
structuredData:
12+
showOrganization: True
13+
howTo:
14+
name: "How to convert documents with AI agents using MCP"
15+
description: "Use any MCP-compatible AI agent to convert documents between PDF, Word, Excel, PowerPoint, Markdown, and 100+ other formats — this guide shows the pattern once and links every specific scenario."
16+
steps:
17+
- name: "Install the server"
18+
text: "Run the GroupDocs.Conversion MCP server with Docker or dnx and register it in your AI client."
19+
- name: "Put the documents in the storage folder"
20+
text: "Point GROUPDOCS_MCP_STORAGE_PATH at the folder that holds the files the agent should use."
21+
- name: "Ask the agent"
22+
text: "Convert contract.docx to PDF"
1023
---
1124

1225
Use any MCP-compatible AI agent — Claude, Cursor, GitHub Copilot, Windsurf, Codex — to convert documents between PDF, Word, Excel, PowerPoint, Markdown, and 100+ other formats, **locally**. Install the GroupDocs.Conversion MCP server with one command, then ask in plain language:
@@ -15,22 +28,22 @@ Use any MCP-compatible AI agent — Claude, Cursor, GitHub Copilot, Windsurf, Co
1528
dnx GroupDocs.Conversion.Mcp --yes
1629
```
1730

18-
{{< alert style="info" >}}
19-
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
20-
{{< /alert >}}
21-
2231
> Convert contract.docx to PDF
2332
2433
This page shows the pattern once; every specific scenario links from here.
2534

35+
{{< alert style="info" >}}
36+
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
37+
{{< /alert >}}
38+
2639
## The division of labor
2740

2841
AI agents are excellent at deciding *what* to do with documents — and unreliable at *doing* it. Rendering fidelity, fonts, tables, page geometry: that is deterministic engine work, not generation work. The MCP pattern puts each side where it belongs:
2942

3043
* **The agent** interprets your intent, picks files, chooses tools, sequences steps, handles results.
3144
* **The engine** (GroupDocs.Conversion — the same one behind the .NET/Java libraries) performs the conversion with production fidelity.
3245

33-
The server exposes three tools — [`convert`]({{< ref "conversion/mcp/tools-reference/convert.md" >}}), [`get_supported_formats`]({{< ref "conversion/mcp/tools-reference/get-supported-formats.md" >}}), [`get_document_info`]({{< ref "conversion/mcp/tools-reference/get-document-info.md" >}}) — and your prompts drive them.
46+
The server's tools — [`convert`]({{< ref "conversion/mcp/tools-reference/convert.md" >}}), [`get_supported_formats`]({{< ref "conversion/mcp/tools-reference/get-supported-formats.md" >}}), [`get_document_info`]({{< ref "conversion/mcp/tools-reference/get-document-info.md" >}}), and [`get_license_status`]({{< ref "conversion/mcp/tools-reference/get-license-status.md" >}}) — are listed in the [tools reference]({{< ref "conversion/mcp/tools-reference/_index.md" >}}); your prompts drive them.
3447

3548
## Setup (once)
3649

‎mcp/use-cases/convert-pdf-to-markdown.md‎

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,24 @@
22
id: mcp-convert-pdf-to-markdown
33
url: conversion/mcp/use-cases/convert-pdf-to-markdown
44
title: How to convert PDF to Markdown with an MCP server
5+
linkTitle: PDF to Markdown
56
weight: 2
67
description: "Convert PDF files to clean, LLM-ready Markdown for your RAG pipeline or knowledge base — locally via MCP, with headings, tables, and lists preserved, and no document ever uploaded to a cloud service."
78
keywords: convert PDF to Markdown MCP, PDF to LLM-ready Markdown, parse PDF for RAG locally, PDF to clean Markdown tables
89
productName: GroupDocs.Conversion MCP Server
910
toc: True
11+
structuredData:
12+
showOrganization: True
13+
howTo:
14+
name: "How to convert PDF to Markdown with an MCP server"
15+
description: "Convert PDF files to clean, LLM-ready Markdown for your RAG pipeline or knowledge base — locally via MCP, with headings, tables, and lists preserved, and no document ever uploaded to a cloud service."
16+
steps:
17+
- name: "Install the server"
18+
text: "Run the GroupDocs.Conversion MCP server with Docker or dnx and register it in your AI client."
19+
- name: "Put the documents in the storage folder"
20+
text: "Point GROUPDOCS_MCP_STORAGE_PATH at the folder that holds the files the agent should use."
21+
- name: "Ask the agent"
22+
text: "Convert report.pdf to Markdown"
1023
---
1124

1225
Convert PDF files to clean, **LLM-ready Markdown** for your RAG pipeline or knowledge base — locally via MCP, with headings, tables, and lists preserved, and no document ever uploaded to a cloud service. Install the server and ask your agent:
@@ -15,14 +28,14 @@ Convert PDF files to clean, **LLM-ready Markdown** for your RAG pipeline or know
1528
dnx GroupDocs.Conversion.Mcp --yes
1629
```
1730

18-
{{< alert style="info" >}}
19-
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
20-
{{< /alert >}}
21-
2231
> Convert report.pdf to Markdown
2332
2433
The agent calls the [`convert`]({{< ref "conversion/mcp/tools-reference/convert.md" >}}) tool with `format: "md"`; `report.md` appears in your output folder.
2534

35+
{{< alert style="info" >}}
36+
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
37+
{{< /alert >}}
38+
2639
## Why local matters here
2740

2841
Every RAG pipeline starts with document → Markdown. Doing that through a cloud parser means every contract, patient record, and internal report transits someone else's infrastructure — precisely the documents you are building a *private* knowledge base for. The MCP server runs the conversion on your machine through the GroupDocs engine: **local-first by architecture**, not by policy.

‎mcp/use-cases/export-markdown-to-pdf-word.md‎

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,24 @@
22
id: mcp-export-markdown-to-pdf-word
33
url: conversion/mcp/use-cases/export-markdown-to-pdf-word
44
title: How to export Markdown to PDF or Word with an MCP server
5+
linkTitle: Markdown to PDF/Word
56
weight: 3
67
description: "Ask your AI agent to export any Markdown file or generated content to a polished PDF or Word document — with tables, code blocks, and structure preserved — using the GroupDocs.Conversion MCP server, locally."
78
keywords: convert markdown to PDF MCP, markdown to Word docx MCP server, export Claude output to PDF, AI generate professional PDF report
89
productName: GroupDocs.Conversion MCP Server
910
toc: True
11+
structuredData:
12+
showOrganization: True
13+
howTo:
14+
name: "How to export Markdown to PDF or Word with an MCP server"
15+
description: "Ask your AI agent to export any Markdown file or generated content to a polished PDF or Word document — with tables, code blocks, and structure preserved — using the GroupDocs.Conversion MCP server, locally."
16+
steps:
17+
- name: "Install the server"
18+
text: "Run the GroupDocs.Conversion MCP server with Docker or dnx and register it in your AI client."
19+
- name: "Put the documents in the storage folder"
20+
text: "Point GROUPDOCS_MCP_STORAGE_PATH at the folder that holds the files the agent should use."
21+
- name: "Ask the agent"
22+
text: "Save your analysis as analysis.md, then convert it to PDF"
1023
---
1124

1225
Ask your AI agent to export any Markdown file — or the content it just generated — to a **polished PDF or Word document**, with tables, code blocks, and document structure preserved, using the GroupDocs.Conversion MCP server, locally:
@@ -15,14 +28,14 @@ Ask your AI agent to export any Markdown file — or the content it just generat
1528
dnx GroupDocs.Conversion.Mcp --yes
1629
```
1730

18-
{{< alert style="info" >}}
19-
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
20-
{{< /alert >}}
21-
2231
> Save your analysis as analysis.md, then convert it to PDF
2332
2433
Agents write Markdown natively; your stakeholders read PDF and Word. This page closes that gap without a headless browser, LaTeX toolchain, or cloud renderer — the conversion runs through a real layout engine on your machine.
2534

35+
{{< alert style="info" >}}
36+
The commands and config snippets on this page are for the **.NET** build of the server — the only platform available today. Installation and client setup: [MCP server for .NET]({{< ref "conversion/net/mcp/_index.md" >}}). Other platforms will expose the same tools with their own launch command; everything else on this page applies unchanged.
37+
{{< /alert >}}
38+
2639
## Setup
2740

2841
Same one-time registration as every scenario — [per-client reference]({{< ref "conversion/net/mcp/install-in-ai-clients.md" >}}). The agent needs a storage folder it can write Markdown into and convert from:

0 commit comments

Comments
 (0)