You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 6ac449c
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: mcp/_index.md
+15-6Lines changed: 15 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,19 +10,28 @@ hideChildren: True
10
10
toc: True
11
11
---
12
12
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:
With the .NET 10 SDK installed, the same server also runs without Docker:
14
23
15
24
```bash
16
25
dnx GroupDocs.Conversion.Mcp --yes
17
26
```
18
27
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).
20
29
21
30
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.
22
31
23
32
## What you can do
24
33
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" >}})):
26
35
27
36
***`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.
28
37
***`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
38
47
| Platform | Status | Install and setup |
39
48
|---|---|---|
40
49
| .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)|
Copy file name to clipboardExpand all lines: mcp/use-cases/_index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ description: "Step-by-step scenarios for converting documents with AI agents ove
7
7
keywords: MCP document conversion use cases, convert documents with AI examples, Claude document conversion scenarios
8
8
productName: GroupDocs.Conversion MCP Server
9
9
hideChildren: True
10
-
toc: True
10
+
toc: False
11
11
---
12
12
13
13
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:
title: How to batch-convert a folder of documents with an AI agent
5
+
linkTitle: Batch-convert a folder
5
6
weight: 4
6
7
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."
7
8
keywords: batch convert files with Claude, convert entire folder AI agent, bulk document conversion MCP, batch processing MCP server
8
9
productName: GroupDocs.Conversion MCP Server
9
10
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"
10
23
---
11
24
12
25
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
15
28
16
29
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.
17
30
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
+
18
35
## The key setting: the storage folder
19
36
20
37
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
35
52
}
36
53
```
37
54
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
-
42
55
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" >}}).)
title: How to convert documents with AI agents using MCP
5
+
linkTitle: Convert with AI agents
5
6
weight: 1
6
7
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."
7
8
keywords: how to convert documents with AI, MCP for documents, AI agent convert docx to pdf, convert files with Claude
8
9
productName: GroupDocs.Conversion MCP Server
9
10
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"
10
23
---
11
24
12
25
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
15
28
dnx GroupDocs.Conversion.Mcp --yes
16
29
```
17
30
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
-
22
31
> Convert contract.docx to PDF
23
32
24
33
This page shows the pattern once; every specific scenario links from here.
25
34
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
+
26
39
## The division of labor
27
40
28
41
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:
***The engine** (GroupDocs.Conversion — the same one behind the .NET/Java libraries) performs the conversion with production fidelity.
32
45
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.
title: How to convert PDF to Markdown with an MCP server
5
+
linkTitle: PDF to Markdown
5
6
weight: 2
6
7
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."
7
8
keywords: convert PDF to Markdown MCP, PDF to LLM-ready Markdown, parse PDF for RAG locally, PDF to clean Markdown tables
8
9
productName: GroupDocs.Conversion MCP Server
9
10
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"
10
23
---
11
24
12
25
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
15
28
dnx GroupDocs.Conversion.Mcp --yes
16
29
```
17
30
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
-
22
31
> Convert report.pdf to Markdown
23
32
24
33
The agent calls the [`convert`]({{< ref "conversion/mcp/tools-reference/convert.md" >}}) tool with `format: "md"`; `report.md` appears in your output folder.
25
34
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
+
26
39
## Why local matters here
27
40
28
41
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.
title: How to export Markdown to PDF or Word with an MCP server
5
+
linkTitle: Markdown to PDF/Word
5
6
weight: 3
6
7
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."
7
8
keywords: convert markdown to PDF MCP, markdown to Word docx MCP server, export Claude output to PDF, AI generate professional PDF report
8
9
productName: GroupDocs.Conversion MCP Server
9
10
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"
10
23
---
11
24
12
25
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
15
28
dnx GroupDocs.Conversion.Mcp --yes
16
29
```
17
30
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
-
22
31
> Save your analysis as analysis.md, then convert it to PDF
23
32
24
33
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.
25
34
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
+
26
39
## Setup
27
40
28
41
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