# Tools reference Complete reference of every tool the GroupDocs.Annotation MCP server exposes to AI agents, with parameters, example prompts, and results. Complete reference of every tool the GroupDocs.Annotation MCP server exposes to AI agents, with parameters, example prompts, and results. Captured from a live `tools/list` call against server version **26.9.0** (raw capture: `tools-list.generated.json` in this section's source). | Tool | What it does | |---|---| | [`get_annotations`]({{< ref "annotation/mcp/tools-reference/get-annotations.md" >}}) | Lists every annotation in a document as JSON, with IDs, positions, and replies | | [`add_annotation`]({{< ref "annotation/mcp/tools-reference/add-annotation.md" >}}) | Adds a highlight, comment, arrow, or other annotation and saves an annotated copy | | [`update_annotation`]({{< ref "annotation/mcp/tools-reference/update-annotation.md" >}}) | Edits an existing annotation's message or bounding box | | [`remove_annotations`]({{< ref "annotation/mcp/tools-reference/remove-annotations.md" >}}) | Removes annotations by ID, or clears all of them | | [`add_reply`]({{< ref "annotation/mcp/tools-reference/add-reply.md" >}}) | Adds a reply to an existing annotation — comment threads for review cycles | | [`remove_replies`]({{< ref "annotation/mcp/tools-reference/remove-replies.md" >}}) | Removes replies by ID, by author, or all of them | | [`export_annotations`]({{< ref "annotation/mcp/tools-reference/export-annotations.md" >}}) | Exports a document's annotations to an XML file | | [`import_annotations`]({{< ref "annotation/mcp/tools-reference/import-annotations.md" >}}) | Merges annotations from an XML file or another annotated document | | [`generate_pages_preview`]({{< ref "annotation/mcp/tools-reference/generate-pages-preview.md" >}}) | Renders pages as PNG images the AI client can display inline | | [`get_document_info`]({{< ref "annotation/mcp/tools-reference/get-document-info.md" >}}) | Returns file type, page count, size, and per-page dimensions | | [`get_license_status`]({{< ref "annotation/mcp/tools-reference/get-license-status.md" >}}) | Reports the active licensing mode and, under metered licensing, consumption | ## The FileInput shape Every tool takes its document through the same `file` object — pass **either** a name from your storage folder **or** inline content: ```json { "file": { "filePath": "contract.pdf" } } ``` | Field | Type | Description | |---|---|---| | `filePath` | string | File path or name in the configured storage folder | | `fileContent` | string | Base64-encoded file content (alternative to `filePath`) | | `fileName` | string | Original filename with extension — required with `fileContent`. It also works on its own, resolved from the storage folder exactly like `filePath` | You rarely write this JSON yourself: the AI agent does, from your plain-language prompt. Missing files are not an error to fear — the tool responds with the list of available files so the agent can correct itself. ## Contents - [get_annotations](https://docs.groupdocs.com/annotation/mcp/tools-reference/get-annotations.md) - [add_annotation](https://docs.groupdocs.com/annotation/mcp/tools-reference/add-annotation.md) - [update_annotation](https://docs.groupdocs.com/annotation/mcp/tools-reference/update-annotation.md) - [remove_annotations](https://docs.groupdocs.com/annotation/mcp/tools-reference/remove-annotations.md) - [add_reply](https://docs.groupdocs.com/annotation/mcp/tools-reference/add-reply.md) - [remove_replies](https://docs.groupdocs.com/annotation/mcp/tools-reference/remove-replies.md) - [export_annotations](https://docs.groupdocs.com/annotation/mcp/tools-reference/export-annotations.md) - [import_annotations](https://docs.groupdocs.com/annotation/mcp/tools-reference/import-annotations.md) - [generate_pages_preview](https://docs.groupdocs.com/annotation/mcp/tools-reference/generate-pages-preview.md) - [get_document_info](https://docs.groupdocs.com/annotation/mcp/tools-reference/get-document-info.md) - [get_license_status](https://docs.groupdocs.com/annotation/mcp/tools-reference/get-license-status.md)