{
  "markdown": "# GroupDocs.Total MCP Server\n\nUnified MCP server that exposes the full [GroupDocs.Total](https://products.groupdocs.com/total) document-processing toolset — annotation, comparison, conversion, markdown, merging, metadata, parsing, redaction, signing, watermarking, plus cross-product document inspection and page preview — as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents. Designed to be used **standalone** — attaching the individual product MCPs (GroupDocs.Annotation.Mcp, GroupDocs.Signature.Mcp, …) alongside is unnecessary and would duplicate tools.\n\n[![GHCR](https://img.shields.io/badge/GHCR-total--net--mcp-2496ED?logo=docker&logoColor=white)](https://github.com/orgs/groupdocs-total/packages/container/package/total-net-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed_(OCI)-6f42c1)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.groupdocs-total/groupdocs-total-mcp)\n[![Integration tests](https://github.com/groupdocs-total/GroupDocs.Total.Mcp.Tests/actions/workflows/integration.yml/badge.svg)](https://github.com/groupdocs-total/GroupDocs.Total.Mcp.Tests/actions/workflows/integration.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n<!-- TODO(manual): record 30s demo per improvement-plan M1 -->\n<!-- ![Demo](assets/demo.gif) -->\n\n## Installation\n\n<!-- install-buttons:start - generated by install/generate-install-links.ps1; do not edit by hand -->\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF)](https://vscode.dev/redirect/mcp/install?name=groupdocs-total&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2Fpath%2Fto%2Fdocuments%3A%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_STORAGE_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_OUTPUT_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_LICENSE_PATH%3D%22%2C%22ghcr.io%2Fgroupdocs-total%2Ftotal-net-mcp%3Alatest%22%5D%7D) [![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5)](https://insiders.vscode.dev/redirect/mcp/install?name=groupdocs-total&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2Fpath%2Fto%2Fdocuments%3A%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_STORAGE_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_OUTPUT_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_LICENSE_PATH%3D%22%2C%22ghcr.io%2Fgroupdocs-total%2Ftotal-net-mcp%3Alatest%22%5D%7D&quality=insiders) [![Add to Cursor](https://img.shields.io/badge/Cursor-Add_MCP-111111)](https://cursor.com/en/install-mcp?name=groupdocs-total&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItLXJtIiwiLWkiLCItdiIsIi9wYXRoL3RvL2RvY3VtZW50czovZGF0YSIsIi1lIiwiR1JPVVBET0NTX01DUF9TVE9SQUdFX1BBVEg9L2RhdGEiLCItZSIsIkdST1VQRE9DU19NQ1BfT1VUUFVUX1BBVEg9L2RhdGEiLCItZSIsIkdST1VQRE9DU19MSUNFTlNFX1BBVEg9IiwiZ2hjci5pby9ncm91cGRvY3MtdG90YWwvdG90YWwtbmV0LW1jcDpsYXRlc3QiXX0%3D) [![Codex CLI setup](https://img.shields.io/badge/Codex_CLI-Setup-e5541b)](install/generated/codex.md) [![Windsurf setup](https://img.shields.io/badge/Windsurf-Setup-0e8a7d)](install/generated/windsurf.md)\n\n> One-click installs pre-fill every supported setting: edit the placeholder host path in\n> the volume mount after install; an empty GROUPDOCS_LICENSE_PATH runs in evaluation mode.\n>\n> **More clients** - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022,\n> Cursor, Windsurf, Cline, and JetBrains Rider live in [`install/generated/`](install/generated/).\n<!-- install-buttons:end -->\n\n**This product ships via Docker (GHCR) only.** GroupDocs.Total bundles every engine (including Parser's embedded ONNX models), so the packed tool far exceeds NuGet.org's 250 MB limit - so `dnx` and\n`dotnet tool install` are **not available** for it. When upstream ships a\nslimmer engine that packs under the limit, the standard NuGet flow returns\n(see the revert notes in `.github/workflows/publish_prod.yml`).\n\n```bash\ndocker run --rm -i \\\n  -v $(pwd)/documents:/data \\\n  ghcr.io/groupdocs-total/total-net-mcp:latest\n```\n\nImages are multi-arch (`linux/amd64` + `linux/arm64`), tagged `latest` plus an\nimmutable version tag per release (e.g. `:26.9.0`). To pin, replace `:latest`\nwith the version tag - recommended for shared configs and CI.\n\n## Available MCP Tools (38 total)\n\nTools follow `{Product}{Verb}{Noun}` PascalCase to disambiguate across domains. Cross-product tools stay short.\n\n### Cross-product (2)\n\n| Tool | Description |\n|---|---|\n| `GetDocumentInfo` | File type, page count, size as JSON for any document (170+ formats via Parser engine) |\n| `GetDocumentPageImage` | Render up to 5 pages as inline PNG images (Viewer engine, 170+ formats) |\n\n### Annotation (8)\n\n| Tool | Description |\n|---|---|\n| `AnnotationAddAnnotation` | Add textfield / area / point / arrow / highlight / underline / strikeout annotation |\n| `AnnotationGetAnnotations` | List all annotations as JSON (id, type, message, page, box, user, replies) |\n| `AnnotationUpdateAnnotation` | Modify an existing annotation's message and/or bounding box by id |\n| `AnnotationRemoveAnnotations` | Remove annotations by id list, or all |\n| `AnnotationAddReply` | Add a reply / comment thread to an existing annotation |\n| `AnnotationRemoveReplies` | Remove replies by id, by user name, or all |\n| `AnnotationImportAnnotations` | Import annotations from XML or another annotated document |\n| `AnnotationExportAnnotations` | Extract annotations to XML (re-importable via Import) |\n\n### Signature (7)\n\n| Tool | Description |\n|---|---|\n| `SignatureSign` | Sign with text / qrcode / barcode / digital certificate signature |\n| `SignatureVerify` | Verify signatures, return JSON validity report |\n| `SignatureSearchTextSignatures` | Find embedded text signatures with optional substring filter |\n| `SignatureSearchBarcodes` | Find barcode signatures with optional decoded-text filter |\n| `SignatureSearchQrCodes` | Find QR code signatures with optional decoded-text filter |\n| `SignatureSearchDigitalSignatures` | Find digital certificate signatures (signer, issuer, validity) |\n| `SignatureSearchImageSignatures` | Find embedded image signatures, return as base64 PNGs |\n\n### Comparison (1) · Conversion (2) · Markdown (2)\n\n| Tool | Description |\n|---|---|\n| `ComparisonCompare` | Compare two documents, produce annotated diff document |\n| `ConversionConvert` | Convert between PDF, Office, image, HTML, and 50+ more formats |\n| `ConversionGetSupportedFormats` | List every output format the document can be converted TO |\n| `MarkdownConvertToMarkdown` | Convert PDF / Office / EPUB / MOBI to clean Markdown |\n| `MarkdownComposeFromMarkdown` | Compose DOCX / PDF / HTML from Markdown source |\n\n### Merger (2) · Metadata (2)\n\n| Tool | Description |\n|---|---|\n| `MergerMerge` | Combine up to 4 documents into one (PDF / Office / HTML / images) |\n| `MergerSplit` | Split a document into separate files by page numbers |\n| `MetadataReadMetadata` | Read all metadata properties (author, title, EXIF, XMP, IPTC, custom) as JSON |\n| `MetadataRemoveMetadata` | Strip all metadata and save a clean copy |\n\n### Parser (5) · Redaction (4) · Watermark (3)\n\n| Tool | Description |\n|---|---|\n| `ParserExtractText` | Extract plain text (page-by-page or whole document) |\n| `ParserExtractImages` | Extract embedded images and save them to storage |\n| `ParserExtractTables` | Extract tables as Markdown or JSON |\n| `ParserExtractMetadata` | Extract metadata fields (separate from MetadataReadMetadata; Parser-format-aware) |\n| `ParserExtractBarcodes` | Find and decode embedded barcodes in document pages |\n| `RedactionRedactText` | Redact text matching a regex with a replacement string |\n| `RedactionRedactImageArea` | Black out a rectangular region of a document page |\n| `RedactionRedactAnnotations` | Redact or delete annotations matching a regex |\n| `RedactionEraseMetadata` | Strip metadata via the Redaction engine (handles formats Metadata can't) |\n| `WatermarkAddWatermark` | Add a text watermark with configurable font, rotation, opacity |\n| `WatermarkSearchWatermarks` | List existing watermarks (type, text, position, page) as JSON |\n| `WatermarkRemoveWatermarks` | Remove watermarks by text filter or all |\n\n## Example prompts\n\n- \"Convert contract.docx to PDF, then sign it with a QR code containing 'Signed by Alice', then watermark every page with 'CONFIDENTIAL'\"\n- \"Compare old.pdf and new.pdf, list every annotation in the result, and preview page 1\"\n- \"Extract all tables from report.xlsx as Markdown and redact every email address\"\n- \"Read the metadata of every PDF in /uploads, then strip it, then preview the cleaned page 1 of each\"\n- \"Find every barcode in invoice.pdf, then merge invoice.pdf + receipt.pdf into combined.pdf\"\n\n## Licensing\n\n**The MCP server itself is MIT; the underlying GroupDocs engines require a license\nfor production use.** Without one the server runs in **evaluation mode**:\n\n- Each bundled engine applies its own evaluation limits: output watermarks / evaluation notices, page limits, and per-process document-open caps (1-15 documents depending on the engine).\n\nTo lift the limits, mount your `GroupDocs.Total.lic` into the container and point\n`GROUPDOCS_LICENSE_PATH` at it (see the Claude Desktop example above):\n\n- [Get a free 30-day temporary license](https://purchase.groupdocs.com/temporary-license/)\n- [Purchase a license](https://purchase.groupdocs.com/pricing/total/net) | [Product page](https://products.groupdocs.com/total/net/)\n\n## Configuration\n\n| Variable | Description | Default |\n|---|---|---|\n| `GROUPDOCS_MCP_STORAGE_PATH` | Base folder for input and output files | current directory |\n| `GROUPDOCS_MCP_OUTPUT_PATH` | *(Optional)* separate folder for output files | `GROUPDOCS_MCP_STORAGE_PATH` |\n| `GROUPDOCS_LICENSE_PATH` | Path to GroupDocs license file | (evaluation mode) |\n\n## Usage with Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"groupdocs-total\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"-v\", \"/path/to/documents:/data\", \"ghcr.io/groupdocs-total/total-net-mcp:latest\"]\n    }\n  }\n}\n```\n\n> To use a license, add `\"-v\", \"/path/to/license-folder:/license\", \"-e\",\n> \"GROUPDOCS_LICENSE_PATH=/license/GroupDocs.Total.lic\"` before the image name.\n> To pin a version, replace `:latest` with the release tag.\n\n## Usage with VS Code / GitHub Copilot\n\nUse the **Install in VS Code** button above, or add to `.vscode/mcp.json`\n(also in [`install/generated/vscode-mcp.json`](install/generated/vscode-mcp.json)):\n\n```json\n{\n  \"inputs\": [\n    {\n      \"type\": \"promptString\",\n      \"id\": \"storage_path\",\n      \"description\": \"Base folder for input and output files.\",\n      \"password\": false\n    }\n  ],\n  \"servers\": {\n    \"groupdocs-total\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"-v\", \"${input:storage_path}:/data\", \"ghcr.io/groupdocs-total/total-net-mcp:latest\"]\n    }\n  }\n}\n```\n\n## Usage with Docker Compose\n\n```bash\ncd docker\ndocker compose up\n```\n\nEdit `docker/docker-compose.yml` to point volumes at your local documents folder.\n\n## License\n\nMIT — see [LICENSE](LICENSE)\n\n<!-- mcp-name: io.github.groupdocs-total/groupdocs-total-mcp -->\n",
  "bytes": 11193,
  "sha": "7ebd5ca7aa095b1f565bd9cf8e5a7d569ef5b31b47b26937d4f4724327119614",
  "repo_slug": "groupdocs-total/groupdocs.total.mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_groupdocs_total_groupdocs_tota_2b0cb544/readme"
}