Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Groupdocs Annotation MCP

by groupdocs-annotationversion 26.11.0i★ 0iRuns on your computerRepository ↗
Registry nameio.github.groupdocs-annotation/groupdocs-annotation-mcp

How to install

What it does

MCP server for GroupDocs.Annotation — add, list, update, remove document annotations via AI agents.

  • Connects Runs on your computer
  • Account or key Needs GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY
  • Category Docs, sheets & office work

Use together with

Skills that teach the AI this kind of work; they work alongside this one

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

by opendatalab★ 83,7441 skills

Skill · How-to guideNo license stated

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

by guillaumemeyer★ 27,5911 skills

Skill · How-to guide

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

by kepano★ 52,906 (whole repo)5 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Groupdocs Annotation MCP. Follow https://mcp.popnx.com/i/groupdocs-annotation-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

You need a Groupdocs Annotation MCP key (create it on the maker’s site) · Only the Claude desktop app (Windows or Mac), not the web or phone

Let AI install it

Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Groupdocs Annotation MCP for Claude on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "groupdocs-annotation": { "command": "dnx", "args": [ "GroupDocs.Annotation.Mcp", "--yes" ], "env": { "GROUPDOCS_METERED_PUBLIC_KEY": "your-value", "GROUPDOCS_METERED_PRIVATE_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Groupdocs Annotation MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Sign up and create a Groupdocs Annotation MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  2. Open the Claude desktop app’s settings file

    SettingsDeveloperEdit Config

  3. Paste these settings and save the file

    {
      "mcpServers": {
        "groupdocs-annotation": {
          "command": "dnx",
          "args": [
            "GroupDocs.Annotation.Mcp",
            "--yes"
          ],
          "env": {
            "GROUPDOCS_METERED_PUBLIC_KEY": "your-value",
            "GROUPDOCS_METERED_PRIVATE_KEY": "your-value"
          }
        }
      }
    }

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Quit Claude and open it again

  5. Try it

    Use Groupdocs Annotation MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Groupdocs Annotation MCP or shows a Groupdocs Annotation MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GROUPDOCS_MCP_STORAGE_PATH · default {storage_path}
  • GROUPDOCS_MCP_OUTPUT_PATH · default {output_path}
  • GROUPDOCS_LICENSE_PATH · default {license_path}

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Groupdocs Annotation MCP yet

Groupdocs Annotation MCP runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect Groupdocs Annotation MCP

  • You need a Groupdocs Annotation MCP key (create it on the maker’s site) · Only the Claude desktop app (Windows or Mac), not the web or phone
  • You need a Groupdocs Annotation MCP key (create it on the maker’s site)
  • You need a Groupdocs Annotation MCP key (create it on the maker’s site)
  • You need a Groupdocs Annotation MCP key (create it on the maker’s site)

B · Others in Docs, sheets & office work that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code, with some setup first

You need a Groupdocs Annotation MCP key (create it on the maker’s site)

Let AI install it

Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Groupdocs Annotation MCP for Claude Code on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user groupdocs-annotation --env GROUPDOCS_METERED_PUBLIC_KEY=your-value --env GROUPDOCS_METERED_PRIVATE_KEY=your-value -- dnx GroupDocs.Annotation.Mcp --yes 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Groupdocs Annotation MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Sign up and create a Groupdocs Annotation MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --scope user groupdocs-annotation --env GROUPDOCS_METERED_PUBLIC_KEY=your-value --env GROUPDOCS_METERED_PRIVATE_KEY=your-value -- dnx GroupDocs.Annotation.Mcp --yes

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Type /mcp in Claude Code

    You should see Groupdocs Annotation MCP listed as connected

  5. Try it

    Use Groupdocs Annotation MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Groupdocs Annotation MCP or shows a Groupdocs Annotation MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GROUPDOCS_MCP_STORAGE_PATH · default {storage_path}
  • GROUPDOCS_MCP_OUTPUT_PATH · default {output_path}
  • GROUPDOCS_LICENSE_PATH · default {license_path}

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

You need a Groupdocs Annotation MCP key (create it on the maker’s site)

Let AI install it

Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Groupdocs Annotation MCP for Cursor on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "groupdocs-annotation": { "command": "dnx", "args": [ "GroupDocs.Annotation.Mcp", "--yes" ], "env": { "GROUPDOCS_METERED_PUBLIC_KEY": "your-value", "GROUPDOCS_METERED_PRIVATE_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Groupdocs Annotation MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Sign up and create a Groupdocs Annotation MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Fill in your key

    In the Groupdocs Annotation MCP settings, GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in Cursor in Agent mode

  5. Try it

    Use Groupdocs Annotation MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Groupdocs Annotation MCP or shows a Groupdocs Annotation MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GROUPDOCS_MCP_STORAGE_PATH · default {storage_path}
  • GROUPDOCS_MCP_OUTPUT_PATH · default {output_path}
  • GROUPDOCS_LICENSE_PATH · default {license_path}

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

You need a Groupdocs Annotation MCP key (create it on the maker’s site)

Let AI install it

Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.

Please install the MCP server Groupdocs Annotation MCP for VS Code on this computer, in this order: 1) 2) Use only this config (already checked by PopNx MCP): { "servers": { "groupdocs-annotation": { "type": "stdio", "command": "dnx", "args": [ "GroupDocs.Annotation.Mcp", "--yes" ], "env": { "GROUPDOCS_METERED_PUBLIC_KEY": "your-value", "GROUPDOCS_METERED_PRIVATE_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Groupdocs Annotation MCP tools really show up.

This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.

  1. Sign up and create a Groupdocs Annotation MCP key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    How to get a key is in the maker’s README below

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Fill in your key

    In the Groupdocs Annotation MCP settings, GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in VS Code in Agent mode

  5. Try it

    Use Groupdocs Annotation MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Groupdocs Annotation MCP or shows a Groupdocs Annotation MCP tool in the answer, you are connected

3 optional setting(s) (works without them)

The command above works without these. Add them only if you want to change something, following the maker’s description.

  • GROUPDOCS_MCP_STORAGE_PATH · default {storage_path}
  • GROUPDOCS_MCP_OUTPUT_PATH · default {output_path}
  • GROUPDOCS_LICENSE_PATH · default {license_path}

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use Groupdocs Annotation MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user groupdocs-annotation --env GROUPDOCS_METERED_PUBLIC_KEY=your-value --env GROUPDOCS_METERED_PRIVATE_KEY=your-value -- dnx GroupDocs.Annotation.Mcp --yes

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "groupdocs-annotation": {
      "command": "dnx",
      "args": [
        "GroupDocs.Annotation.Mcp",
        "--yes"
      ],
      "env": {
        "GROUPDOCS_METERED_PUBLIC_KEY": "your-value",
        "GROUPDOCS_METERED_PRIVATE_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "groupdocs-annotation": {
      "command": "dnx",
      "args": [
        "GroupDocs.Annotation.Mcp",
        "--yes"
      ],
      "env": {
        "GROUPDOCS_METERED_PUBLIC_KEY": "your-value",
        "GROUPDOCS_METERED_PRIVATE_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "groupdocs-annotation": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "GroupDocs.Annotation.Mcp",
        "--yes"
      ],
      "env": {
        "GROUPDOCS_METERED_PUBLIC_KEY": "your-value",
        "GROUPDOCS_METERED_PRIVATE_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • GROUPDOCS_MCP_STORAGE_PATH env
  • GROUPDOCS_MCP_OUTPUT_PATH env
  • GROUPDOCS_LICENSE_PATH env
  • GROUPDOCS_METERED_PUBLIC_KEY secret required env
  • GROUPDOCS_METERED_PRIVATE_KEY secret required env

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
26.11.0
Published to registryi
Nov 9, 2026
Code last changedi
Nov 9, 2026
Maker
groupdocs-annotation
Packages
nuget: GroupDocs.Annotation.Mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 17, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account groupdocs-annotation, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 8 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/groupdocs-annotation-mcp.svg)](https://mcp.popnx.com/en/servers/groupdocs-annotation-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Docs, sheets & office worki

  • More stars than 0% of the other 4031 servers in this category
  • Published to the registry more recently than 78% of the other 4031 servers in this category
  • Basic checks equal to or better than 99% of the other 4031 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Groupdocs Annotation MCP safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: GROUPDOCS_METERED_PUBLIC_KEY, GROUPDOCS_METERED_PRIVATE_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 8 days ago, and the latest version (26.11.0) reached the registry 8 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need .NET on your computer.

What can I use instead?

In the same category: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

by HeyPuterWidely used★ 44.2KUpdated 5 months ago

Runs in the cloud✓ service owner · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

by getsentryWidely used↓ 130.5K/wk shared package★ 6.6KUpdated 4 months ago

Runs on your computer✓ service owner · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

by Vexa-aiWidely used★ 3KUpdated 2 months ago

Runs in the cloud✓ service owner · vexa.ai

Atlassian Rovo MCP Server

Atlassian’s official server lets AI search and manage Jira work and Confluence pages. Connects to Atlassian’s cloud with OAuth sign-in.

by atlassianGrowing★ 1.2KUpdated 2 months ago

Runs in the cloud✓ service owner · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

by ankimcpGrowing↓ 1.1K/wk★ 561Updated 43 days ago

Runs on your computer✓ service owner · ankimcp.ai
Compared with similar ones
This one
Groupdocs Annotation MCP
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Runs whereInstalls on your computerRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computer
Needs a keyYesNoNoYesNoNo
Add with + in ClaudeNoNoNoNoYesNo
Basic checks3/34/43/32/44/43/3
LicenseMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

GroupDocs.Annotation MCP Server

MCP server that exposes GroupDocs.Annotation as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents.

Installation

One-click installs pre-fill every supported setting: edit the placeholder documents

folder after install (output defaults to the same folder); an empty

GROUPDOCS_LICENSE_PATH runs in evaluation mode - point it at your license to lift limits.

More clients - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022,

Cursor, Windsurf, Cline, and JetBrains Rider live in install/generated/.

Requires .NET 10 SDK.

Run directly with `dnx` (recommended — no install step):

dnx GroupDocs.Annotation.Mcp --yes

Pulls the latest stable release on every invocation. To pin to a specific version (recommended for shared configs and CI), append @ :

dnx GroupDocs.Annotation.Mcp@26.11.0 --yes

Or install as a global dotnet tool:

dotnet tool install -g GroupDocs.Annotation.Mcp

groupdocs-annotation-mcp

Or run via Docker:

docker run --rm -i \

-v $(pwd)/documents:/data \ ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

Native prerequisites

The underlying GroupDocs engine rasterises annotated pages and previews via System.Drawing (GDI+). When you run the server natively (via dnx or the global dotnet tool) on Linux or macOS, install the native libgdiplus library and a fonts package first:

PlatformSetup
WindowsNothing — GDI+ is built into the OS.
Linuxsudo apt-get install -y libgdiplus libfontconfig1 ttf-mscorefonts-installer
macOSbrew install mono-libgdiplus
DockerNothing — the image already bundles libgdiplus, libfontconfig1, and ttf-mscorefonts-installer.

Skipping this on Linux/macOS surfaces as DllNotFoundException: libgdiplus in the tool response. The simplest zero-setup option on Linux/macOS is the Docker image.

Available MCP Tools

ToolDescription
AddAnnotationAdd a textfield / area / point / arrow / highlight / underline / strikeout annotation; saves the annotated file as _annotated.
GetAnnotationsList all annotations in a document as JSON (id, type, message, page, box, user, replies)
UpdateAnnotationModify an existing annotation's message and/or bounding box by id
RemoveAnnotationsRemove annotations by id list, or all if none specified
AddReplyAdd a reply / comment thread to an existing annotation
RemoveRepliesRemove replies by reply-id list, by user name, or all
ImportAnnotationsImport annotations from an XML file or another annotated document into a target file
ExportAnnotationsExtract annotations from a document and save them as XML (re-importable via ImportAnnotations)
GetDocumentInfoReturn file type, page count, size, and per-page dimensions as JSON (no modification)
GeneratePagesPreviewRender up to 5 document pages as inline PNG images so AI clients display them directly

Example prompts

  • "Annotate contract.pdf — add a highlight on page 2 around the indemnity clause and an arrow with the comment 'Needs legal review'"
  • "List every annotation in design-review.docx and group them by author"
  • "Reply to annotation 7 in spec.pdf with 'Implemented in PR #42' under the user 'alice'"
  • "Export the annotations from old.pdf to XML, then re-import them into new.pdf"
  • "Preview page 1 and page 5 of report.pdf with annotations baked in"

Licensing

The MCP server itself is MIT; the underlying GroupDocs.Annotation engine requires a license for production use. Without one the server runs in evaluation mode:

  • Annotated output may carry evaluation watermarks.
  • A single server process can open at most 15 documents; further calls fail with an evaluation-cap error until the server restarts.

There are two ways to license the server.

License file — point GROUPDOCS_LICENSE_PATH at your GroupDocs.Total.lic. Works offline.

Metered (pay-per-use) — set both GROUPDOCS_METERED_PUBLIC_KEY and GROUPDOCS_METERED_PRIVATE_KEY. You are billed for what you actually process, which suits AI agents well because their usage is bursty and hard to predict up front. If both a metered key pair and a license file are configured, metered wins and the file is ignored.

Metered mode needs outbound connectivity. Usage is reported to GroupDocs servers, so

air-gapped or firewalled deployments must allow that egress — or use a license file instead.

Call the `get_license_status` tool at any time to see which mode is active, and — under metered — the consumed quantity and remaining credit.

Keeping the private key out of your config

The metered private key is a secret. MCP client configs are plain files on disk, and a project-scoped .mcp.json is committed by convention, so prefer, in order:

  1. Set the variables in your OS environment and leave them out of the config entirely. An stdio MCP server inherits its client's environment, so this works in every client. On macOS note that an app launched from Finder does not inherit shell exports — use launchctl setenv, or launch the client from a terminal.
  2. Reference them indirectly if your client supports it (Claude Code expands ${VAR}; VS Code uses ${env:VAR} and ${input:...}).
  3. A literal value in a user-scoped config (for example ~/.claude.json) is acceptable for a single developer.
  4. Never commit a literal key in a project-scoped .mcp.json.

For Docker, forward the values without writing them into any file:

docker run --rm -i \

-e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \ -v /path/to/documents:/data \ ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

To lift the limits with a license file:

Configuration

VariableDescriptionDefault
GROUPDOCS_MCP_STORAGE_PATHBase folder for input and output filescurrent directory
GROUPDOCS_MCP_OUTPUT_PATH*(Optional)* separate folder for output filesGROUPDOCS_MCP_STORAGE_PATH
GROUPDOCS_LICENSE_PATHPath to GroupDocs license file(evaluation mode)
GROUPDOCS_METERED_PUBLIC_KEYMetered public key. Requires the private key too; takes precedence over the license file(unset)
GROUPDOCS_METERED_PRIVATE_KEYMetered private key. Secret - see Licensing(unset)

Usage with Claude Desktop

{

"mcpServers": { "groupdocs-annotation": { "type": "stdio", "command": "dnx", "args": ["GroupDocs.Annotation.Mcp", "--yes"], "env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" } } } }

To pin to a specific version, replace "GroupDocs.Annotation.Mcp" with

"GroupDocs.Annotation.Mcp@26.11.0" in args. Pinning is recommended for

shared / committed configs to avoid surprise upgrades.

Usage with VS Code / GitHub Copilot

NuGet.org generates a ready-to-use mcp.json snippet on the package page. Copy it directly into your .vscode/mcp.json.

Alternatively, add manually to .vscode/mcp.json:

{

"inputs": [ { "type": "promptString", "id": "storage_path", "description": "Base folder for input and output files.", "password": false } ], "servers": { "groupdocs-annotation": { "type": "stdio", "command": "dnx", "args": ["GroupDocs.Annotation.Mcp", "--yes"], "env": { "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}" } } } }

Same pinning rule as above — swap "GroupDocs.Annotation.Mcp" for

"GroupDocs.Annotation.Mcp@26.11.0" to lock to a specific release.

Usage with Docker Compose

cd docker

docker compose up

Edit docker/docker-compose.yml to point volumes at your local documents folder.

License

MIT — see LICENSE