rossum-mcp 0.3.5__tar.gz → 0.4.0__tar.gz

{rossum_mcp-0.3.5/rossum_mcp.egg-info → rossum_mcp-0.4.0}/PKG-INFO

@@ -1,10 +1,19 @@
 Metadata-Version: 2.4
 Name: rossum-mcp
-Version: 0.3.5
+Version: 0.4.0
 Summary: MCP server for AI-powered Rossum orchestration: document workflows, debug pipelines automatically, and configure intelligent document processing through natural language.
 Author-email: "Dan Stancl (Rossum AI)" <daniel.stancl@gmail.com>
 License: MIT
 Keywords: mcp,rossum,document-processing
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: fastmcp>2.0.0
@@ -45,11 +54,12 @@ Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "all"
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PyPI - rossum-mcp](https://img.shields.io/pypi/v/rossum-mcp?label=rossum-mcp)](https://pypi.org/project/rossum-mcp/)
 [![Coverage](https://codecov.io/gh/stancld/rossum-mcp/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-mcp)
-[![MCP Tools](https://img.shields.io/badge/MCP_Tools-49-blue.svg)](#available-tools)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-50-blue.svg)](#available-tools)
 
 [![Rossum API](https://img.shields.io/badge/Rossum-API-orange.svg)](https://github.com/rossumai/rossum-api)
 [![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![ty](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json)](https://github.com/astral-sh/ty)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 
 </div>
@@ -64,7 +74,9 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 
 ## Features
 
-### Document Processing
+<details>
+<summary><strong>Document Processing (6 tools)</strong></summary>
+
 - **upload_document**: Upload a document to Rossum for processing
 - **get_annotation**: Retrieve annotation data for a previously uploaded document
 - **list_annotations**: List all annotations for a queue with optional filtering
@@ -72,7 +84,11 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **bulk_update_annotation_fields**: Bulk update annotation field values using JSON Patch operations
 - **confirm_annotation**: Confirm annotation to move it to 'confirmed' status
 
-### Queue & Schema Management
+</details>
+
+<details>
+<summary><strong>Queue & Schema Management (13 tools)</strong></summary>
+
 - **get_queue**: Retrieve queue details including schema_id
 - **list_queues**: List all queues with optional filtering by workspace or name
 - **get_schema**: Retrieve schema details and content
@@ -87,17 +103,29 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **patch_schema**: Add, update, or remove individual schema nodes without replacing entire content
 - **prune_schema_fields**: Efficiently remove multiple fields from schema at once (for organization setup)
 
-### Workspace Management
+</details>
+
+<details>
+<summary><strong>Workspace Management (3 tools)</strong></summary>
+
 - **get_workspace**: Retrieve workspace details by ID
 - **list_workspaces**: List all workspaces with optional filtering
 - **create_workspace**: Create a new workspace
 
-### User Management
+</details>
+
+<details>
+<summary><strong>User Management (3 tools)</strong></summary>
+
 - **get_user**: Retrieve user details by ID
 - **list_users**: List users with optional filtering by username, email, etc.
 - **list_user_roles**: List all user roles (permission groups) in the organization
 
-### Engine Management
+</details>
+
+<details>
+<summary><strong>Engine Management (6 tools)</strong></summary>
+
 - **get_engine**: Retrieve engine details by ID
 - **list_engines**: List all engines with optional filters
 - **create_engine**: Create a new engine (extractor or splitter)
@@ -105,7 +133,11 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **create_engine_field**: Create engine fields and link them to schemas
 - **get_engine_fields**: Retrieve engine fields for a specific engine or all engine fields
 
-### Extensions & Rules
+</details>
+
+<details>
+<summary><strong>Extensions & Rules (9 tools)</strong></summary>
+
 - **get_hook**: Get hook/extension details
 - **list_hooks**: List webhooks and serverless functions (extensions)
 - **create_hook**: Create webhooks or serverless function hooks for custom logic
@@ -116,17 +148,34 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **get_rule**: Get business rule details
 - **list_rules**: List business rules with trigger conditions and actions
 
-### Email Templates
+</details>
+
+<details>
+<summary><strong>Email Templates (3 tools)</strong></summary>
+
 - **get_email_template**: Retrieve email template details by ID
 - **list_email_templates**: List email templates with optional filtering by queue, type, or name
 - **create_email_template**: Create email templates for automated or manual email sending
 
-### Relations Management
+</details>
+
+<details>
+<summary><strong>Relations Management (4 tools)</strong></summary>
+
 - **get_relation**: Retrieve relation details by ID
 - **list_relations**: List all relations between annotations (edit, attachment, duplicate)
 - **get_document_relation**: Retrieve document relation details by ID
 - **list_document_relations**: List all document relations (export, einvoice)
 
+</details>
+
+<details>
+<summary><strong>Tool Discovery (1 tool)</strong></summary>
+
+- **list_tool_categories**: List all available tool categories with descriptions, tool names, and keywords for dynamic tool loading
+
+</details>
+
 ## Prerequisites
 
 - Python 3.12 or higher
@@ -1704,6 +1753,65 @@ template = create_email_template(
 )
 ```
 
+### Tool Discovery
+
+#### list_tool_categories
+
+Lists all available tool categories with their descriptions, tool names, and keywords. This enables dynamic tool loading where agents can discover and load only the tools they need for a specific task.
+
+**Parameters:**
+None
+
+**Returns:**
+```json
+[
+  {
+    "name": "annotations",
+    "description": "Document processing: upload, retrieve, update, and confirm annotations",
+    "tool_count": 6,
+    "tools": [
+      {"name": "upload_document", "description": "Upload document to queue"},
+      {"name": "get_annotation", "description": "Retrieve annotation with extracted data"}
+    ],
+    "keywords": ["annotation", "document", "upload", "extract", "confirm", "review"]
+  },
+  {
+    "name": "queues",
+    "description": "Queue management: create, configure, and list document processing queues",
+    "tool_count": 8,
+    "tools": [
+      {"name": "get_queue", "description": "Retrieve queue details"},
+      {"name": "list_queues", "description": "List all queues"}
+    ],
+    "keywords": ["queue", "inbox", "connector"]
+  }
+]
+```
+
+**Available Categories:**
+- `annotations` - Document processing tools (6 tools)
+- `queues` - Queue management tools (8 tools)
+- `schemas` - Schema management tools (7 tools)
+- `engines` - AI engine management tools (6 tools)
+- `hooks` - Extensions/webhooks tools (7 tools)
+- `email_templates` - Email template tools (3 tools)
+- `document_relations` - Document relation tools (2 tools)
+- `relations` - Annotation relation tools (2 tools)
+- `rules` - Validation rule tools (2 tools)
+- `users` - User management tools (3 tools)
+- `workspaces` - Workspace management tools (3 tools)
+
+**Example usage:**
+```python
+# Discover all tool categories
+categories = list_tool_categories()
+
+# Find categories by keyword matching
+for category in categories:
+    if "schema" in category["keywords"]:
+        print(f"Found: {category['name']} with {category['tool_count']} tools")
+```
+
 ## Annotation Status Workflow
 
 When a document is uploaded, the annotation progresses through various states:

rossum_mcp-0.3.5/PKG-INFO → rossum_mcp-0.4.0/README.md

@@ -1,41 +1,3 @@
-Metadata-Version: 2.4
-Name: rossum-mcp
-Version: 0.3.5
-Summary: MCP server for AI-powered Rossum orchestration: document workflows, debug pipelines automatically, and configure intelligent document processing through natural language.
-Author-email: "Dan Stancl (Rossum AI)" <daniel.stancl@gmail.com>
-License: MIT
-Keywords: mcp,rossum,document-processing
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Requires-Dist: fastmcp>2.0.0
-Requires-Dist: pydantic>2.0.0
-Requires-Dist: rossum-api>=3.7.0
-Provides-Extra: docs
-Requires-Dist: myst-parser>=2.0.0; extra == "docs"
-Requires-Dist: sphinx>=7.0.0; extra == "docs"
-Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "docs"
-Requires-Dist: sphinx-copybutton>=0.5.2; extra == "docs"
-Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
-Provides-Extra: tests
-Requires-Dist: coverage>=7.0.0; extra == "tests"
-Requires-Dist: pytest>=7.0.0; extra == "tests"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "tests"
-Requires-Dist: pytest-cov>=4.0.0; extra == "tests"
-Requires-Dist: redis>=7.0.0; extra == "tests"
-Provides-Extra: all
-Requires-Dist: coverage>=7.0.0; extra == "all"
-Requires-Dist: fastmcp>=1.0.0; extra == "all"
-Requires-Dist: myst-parser>=2.0.0; extra == "all"
-Requires-Dist: pydantic>2.0.0; extra == "all"
-Requires-Dist: pytest>=7.0.0; extra == "all"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "all"
-Requires-Dist: redis>=7.0.0; extra == "all"
-Requires-Dist: rossum-api>=3.7.0; extra == "all"
-Requires-Dist: sphinx>=7.0.0; extra == "all"
-Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "all"
-Requires-Dist: sphinx-copybutton>=0.5.2; extra == "all"
-Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "all"
-
 # Rossum MCP Server
 
 <div align="center">
@@ -45,11 +7,12 @@ Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "all"
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PyPI - rossum-mcp](https://img.shields.io/pypi/v/rossum-mcp?label=rossum-mcp)](https://pypi.org/project/rossum-mcp/)
 [![Coverage](https://codecov.io/gh/stancld/rossum-mcp/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-mcp)
-[![MCP Tools](https://img.shields.io/badge/MCP_Tools-49-blue.svg)](#available-tools)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-50-blue.svg)](#available-tools)
 
 [![Rossum API](https://img.shields.io/badge/Rossum-API-orange.svg)](https://github.com/rossumai/rossum-api)
 [![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io/)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![ty](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ty/main/assets/badge/v0.json)](https://github.com/astral-sh/ty)
 [![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
 
 </div>
@@ -64,7 +27,9 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 
 ## Features
 
-### Document Processing
+<details>
+<summary><strong>Document Processing (6 tools)</strong></summary>
+
 - **upload_document**: Upload a document to Rossum for processing
 - **get_annotation**: Retrieve annotation data for a previously uploaded document
 - **list_annotations**: List all annotations for a queue with optional filtering
@@ -72,7 +37,11 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **bulk_update_annotation_fields**: Bulk update annotation field values using JSON Patch operations
 - **confirm_annotation**: Confirm annotation to move it to 'confirmed' status
 
-### Queue & Schema Management
+</details>
+
+<details>
+<summary><strong>Queue & Schema Management (13 tools)</strong></summary>
+
 - **get_queue**: Retrieve queue details including schema_id
 - **list_queues**: List all queues with optional filtering by workspace or name
 - **get_schema**: Retrieve schema details and content
@@ -87,17 +56,29 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **patch_schema**: Add, update, or remove individual schema nodes without replacing entire content
 - **prune_schema_fields**: Efficiently remove multiple fields from schema at once (for organization setup)
 
-### Workspace Management
+</details>
+
+<details>
+<summary><strong>Workspace Management (3 tools)</strong></summary>
+
 - **get_workspace**: Retrieve workspace details by ID
 - **list_workspaces**: List all workspaces with optional filtering
 - **create_workspace**: Create a new workspace
 
-### User Management
+</details>
+
+<details>
+<summary><strong>User Management (3 tools)</strong></summary>
+
 - **get_user**: Retrieve user details by ID
 - **list_users**: List users with optional filtering by username, email, etc.
 - **list_user_roles**: List all user roles (permission groups) in the organization
 
-### Engine Management
+</details>
+
+<details>
+<summary><strong>Engine Management (6 tools)</strong></summary>
+
 - **get_engine**: Retrieve engine details by ID
 - **list_engines**: List all engines with optional filters
 - **create_engine**: Create a new engine (extractor or splitter)
@@ -105,7 +86,11 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **create_engine_field**: Create engine fields and link them to schemas
 - **get_engine_fields**: Retrieve engine fields for a specific engine or all engine fields
 
-### Extensions & Rules
+</details>
+
+<details>
+<summary><strong>Extensions & Rules (9 tools)</strong></summary>
+
 - **get_hook**: Get hook/extension details
 - **list_hooks**: List webhooks and serverless functions (extensions)
 - **create_hook**: Create webhooks or serverless function hooks for custom logic
@@ -116,17 +101,34 @@ A Model Context Protocol (MCP) server that provides tools for uploading document
 - **get_rule**: Get business rule details
 - **list_rules**: List business rules with trigger conditions and actions
 
-### Email Templates
+</details>
+
+<details>
+<summary><strong>Email Templates (3 tools)</strong></summary>
+
 - **get_email_template**: Retrieve email template details by ID
 - **list_email_templates**: List email templates with optional filtering by queue, type, or name
 - **create_email_template**: Create email templates for automated or manual email sending
 
-### Relations Management
+</details>
+
+<details>
+<summary><strong>Relations Management (4 tools)</strong></summary>
+
 - **get_relation**: Retrieve relation details by ID
 - **list_relations**: List all relations between annotations (edit, attachment, duplicate)
 - **get_document_relation**: Retrieve document relation details by ID
 - **list_document_relations**: List all document relations (export, einvoice)
 
+</details>
+
+<details>
+<summary><strong>Tool Discovery (1 tool)</strong></summary>
+
+- **list_tool_categories**: List all available tool categories with descriptions, tool names, and keywords for dynamic tool loading
+
+</details>
+
 ## Prerequisites
 
 - Python 3.12 or higher
@@ -1704,6 +1706,65 @@ template = create_email_template(
 )
 ```
 
+### Tool Discovery
+
+#### list_tool_categories
+
+Lists all available tool categories with their descriptions, tool names, and keywords. This enables dynamic tool loading where agents can discover and load only the tools they need for a specific task.
+
+**Parameters:**
+None
+
+**Returns:**
+```json
+[
+  {
+    "name": "annotations",
+    "description": "Document processing: upload, retrieve, update, and confirm annotations",
+    "tool_count": 6,
+    "tools": [
+      {"name": "upload_document", "description": "Upload document to queue"},
+      {"name": "get_annotation", "description": "Retrieve annotation with extracted data"}
+    ],
+    "keywords": ["annotation", "document", "upload", "extract", "confirm", "review"]
+  },
+  {
+    "name": "queues",
+    "description": "Queue management: create, configure, and list document processing queues",
+    "tool_count": 8,
+    "tools": [
+      {"name": "get_queue", "description": "Retrieve queue details"},
+      {"name": "list_queues", "description": "List all queues"}
+    ],
+    "keywords": ["queue", "inbox", "connector"]
+  }
+]
+```
+
+**Available Categories:**
+- `annotations` - Document processing tools (6 tools)
+- `queues` - Queue management tools (8 tools)
+- `schemas` - Schema management tools (7 tools)
+- `engines` - AI engine management tools (6 tools)
+- `hooks` - Extensions/webhooks tools (7 tools)
+- `email_templates` - Email template tools (3 tools)
+- `document_relations` - Document relation tools (2 tools)
+- `relations` - Annotation relation tools (2 tools)
+- `rules` - Validation rule tools (2 tools)
+- `users` - User management tools (3 tools)
+- `workspaces` - Workspace management tools (3 tools)
+
+**Example usage:**
+```python
+# Discover all tool categories
+categories = list_tool_categories()
+
+# Find categories by keyword matching
+for category in categories:
+    if "schema" in category["keywords"]:
+        print(f"Found: {category['name']} with {category['tool_count']} tools")
+```
+
 ## Annotation Status Workflow
 
 When a document is uploaded, the annotation progresses through various states:

{rossum_mcp-0.3.5 → rossum_mcp-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rossum-mcp"
-version = "0.3.5"
+version = "0.4.0"
 description = "MCP server for AI-powered Rossum orchestration: document workflows, debug pipelines automatically, and configure intelligent document processing through natural language."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -13,6 +13,17 @@ authors = [
     {name = "Dan Stancl (Rossum AI)", email = "daniel.stancl@gmail.com"}
 ]
 keywords = ["mcp", "rossum", "document-processing"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
 dependencies = [
     "fastmcp>2.0.0",
     "pydantic>2.0.0",

{rossum_mcp-0.3.5 → rossum_mcp-0.4.0}/rossum_mcp/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "0.3.5"
+__version__ = "0.4.0"

{rossum_mcp-0.3.5 → rossum_mcp-0.4.0}/rossum_mcp/server.py

@@ -17,6 +17,7 @@ from rossum_api.dtos import Token
 from rossum_mcp.logging_config import setup_logging
 from rossum_mcp.tools import (
     register_annotation_tools,
+    register_discovery_tools,
     register_document_relation_tools,
     register_email_template_tools,
     register_engine_tools,
@@ -45,6 +46,7 @@ logger.info(f"Rossum MCP Server starting in {MODE} mode")
 mcp = FastMCP("rossum-mcp-server")
 client = AsyncRossumAPIClient(base_url=BASE_URL, credentials=Token(token=API_TOKEN))
 
+register_discovery_tools(mcp)
 register_annotation_tools(mcp, client)
 register_queue_tools(mcp, client)
 register_schema_tools(mcp, client)

{rossum_mcp-0.3.5 → rossum_mcp-0.4.0}/rossum_mcp/tools/__init__.py

@@ -3,6 +3,13 @@
 from __future__ import annotations
 
 from rossum_mcp.tools.annotations import register_annotation_tools
+from rossum_mcp.tools.catalog import (
+    TOOL_CATALOG,
+    ToolCategory,
+    ToolInfo,
+    get_catalog_summary,
+)
+from rossum_mcp.tools.discovery import register_discovery_tools
 from rossum_mcp.tools.document_relations import register_document_relation_tools
 from rossum_mcp.tools.email_templates import register_email_template_tools
 from rossum_mcp.tools.engines import register_engine_tools
@@ -15,7 +22,12 @@ from rossum_mcp.tools.users import register_user_tools
 from rossum_mcp.tools.workspaces import register_workspace_tools
 
 __all__ = [
+    "TOOL_CATALOG",
+    "ToolCategory",
+    "ToolInfo",
+    "get_catalog_summary",
     "register_annotation_tools",
+    "register_discovery_tools",
     "register_document_relation_tools",
     "register_email_template_tools",
     "register_engine_tools",

rossum_mcp-0.4.0/rossum_mcp/tools/catalog.py

@@ -0,0 +1,169 @@
+"""Tool catalog for dynamic tool discovery.
+
+Provides lightweight metadata for all MCP tools organized by category.
+This is the single source of truth for tool categorization - the agent
+fetches this catalog from MCP to avoid data duplication.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class ToolInfo:
+    """Lightweight tool metadata for catalog."""
+
+    name: str
+    description: str
+
+
+@dataclass
+class ToolCategory:
+    """A category of related tools."""
+
+    name: str
+    description: str
+    tools: list[ToolInfo]
+    keywords: list[str]
+
+
+# Tool catalog organized by functional category
+# Keywords enable automatic pre-loading based on user request text
+TOOL_CATALOG: dict[str, ToolCategory] = {
+    "annotations": ToolCategory(
+        name="annotations",
+        description="Document processing: upload, retrieve, update, and confirm annotations",
+        tools=[
+            ToolInfo("upload_document", "Upload document to queue"),
+            ToolInfo("get_annotation", "Retrieve annotation with extracted data"),
+            ToolInfo("list_annotations", "List annotations for a queue"),
+            ToolInfo("start_annotation", "Start annotation (to_review -> reviewing)"),
+            ToolInfo("bulk_update_annotation_fields", "Bulk update annotation fields"),
+            ToolInfo("confirm_annotation", "Confirm annotation (-> confirmed)"),
+        ],
+        keywords=["annotation", "document", "upload", "extract", "confirm", "review"],
+    ),
+    "queues": ToolCategory(
+        name="queues",
+        description="Queue management: create, configure, and list document processing queues",
+        tools=[
+            ToolInfo("get_queue", "Retrieve queue details"),
+            ToolInfo("list_queues", "List all queues"),
+            ToolInfo("get_queue_schema", "Get queue's schema"),
+            ToolInfo("get_queue_engine", "Get queue's AI engine"),
+            ToolInfo("create_queue", "Create a queue"),
+            ToolInfo("update_queue", "Update queue settings"),
+            ToolInfo("get_queue_template_names", "List available queue templates"),
+            ToolInfo("create_queue_from_template", "Create queue from template"),
+        ],
+        keywords=["queue", "inbox", "connector"],
+    ),
+    "schemas": ToolCategory(
+        name="schemas",
+        description="Schema management: define and modify document field structures",
+        tools=[
+            ToolInfo("get_schema", "Retrieve schema details"),
+            ToolInfo("list_schemas", "List all schemas"),
+            ToolInfo("update_schema", "Update schema"),
+            ToolInfo("create_schema", "Create new schema"),
+            ToolInfo("patch_schema", "Add/update/remove schema fields"),
+            ToolInfo("get_schema_tree_structure", "Get lightweight schema tree"),
+            ToolInfo("prune_schema_fields", "Bulk remove schema fields"),
+        ],
+        keywords=["schema", "field", "datapoint", "section", "multivalue", "tuple"],
+    ),
+    "engines": ToolCategory(
+        name="engines",
+        description="AI engine management: create and configure extraction/splitting engines",
+        tools=[
+            ToolInfo("get_engine", "Retrieve engine details"),
+            ToolInfo("list_engines", "List all engines"),
+            ToolInfo("update_engine", "Update engine settings"),
+            ToolInfo("create_engine", "Create new engine"),
+            ToolInfo("create_engine_field", "Create engine field mapping"),
+            ToolInfo("get_engine_fields", "List engine fields"),
+        ],
+        keywords=["engine", "ai", "extractor", "splitter", "training"],
+    ),
+    "hooks": ToolCategory(
+        name="hooks",
+        description="Extensions/webhooks: create and manage automation hooks",
+        tools=[
+            ToolInfo("get_hook", "Retrieve hook details with code"),
+            ToolInfo("list_hooks", "List all hooks for a queue"),
+            ToolInfo("create_hook", "Create new hook"),
+            ToolInfo("update_hook", "Update hook configuration"),
+            ToolInfo("list_hook_logs", "View hook execution logs"),
+            ToolInfo("list_hook_templates", "List Rossum Store templates"),
+            ToolInfo("create_hook_from_template", "Create hook from template"),
+        ],
+        keywords=["hook", "extension", "webhook", "automation", "function", "serverless"],
+    ),
+    "email_templates": ToolCategory(
+        name="email_templates",
+        description="Email templates: configure automated email responses",
+        tools=[
+            ToolInfo("get_email_template", "Retrieve email template"),
+            ToolInfo("list_email_templates", "List email templates"),
+            ToolInfo("create_email_template", "Create email template"),
+        ],
+        keywords=["email", "template", "notification", "rejection"],
+    ),
+    "document_relations": ToolCategory(
+        name="document_relations",
+        description="Document relations: manage export/einvoice document links",
+        tools=[
+            ToolInfo("get_document_relation", "Retrieve document relation"),
+            ToolInfo("list_document_relations", "List document relations"),
+        ],
+        keywords=["document relation", "export", "einvoice"],
+    ),
+    "relations": ToolCategory(
+        name="relations",
+        description="Annotation relations: manage edit/attachment/duplicate links",
+        tools=[
+            ToolInfo("get_relation", "Retrieve relation details"),
+            ToolInfo("list_relations", "List annotation relations"),
+        ],
+        keywords=["relation", "duplicate", "attachment", "edit"],
+    ),
+    "rules": ToolCategory(
+        name="rules",
+        description="Validation rules: manage schema validation rules",
+        tools=[
+            ToolInfo("get_rule", "Retrieve rule details"),
+            ToolInfo("list_rules", "List validation rules"),
+        ],
+        keywords=["rule", "validation", "constraint"],
+    ),
+    "users": ToolCategory(
+        name="users",
+        description="User management: list users and roles",
+        tools=[
+            ToolInfo("get_user", "Retrieve user details"),
+            ToolInfo("list_users", "List users with filters"),
+            ToolInfo("list_user_roles", "List available user roles"),
+        ],
+        keywords=["user", "role", "permission", "token_owner"],
+    ),
+    "workspaces": ToolCategory(
+        name="workspaces",
+        description="Workspace management: organize queues into workspaces",
+        tools=[
+            ToolInfo("get_workspace", "Retrieve workspace details"),
+            ToolInfo("list_workspaces", "List all workspaces"),
+            ToolInfo("create_workspace", "Create new workspace"),
+        ],
+        keywords=["workspace", "organization"],
+    ),
+}
+
+
+def get_catalog_summary() -> str:
+    """Get a compact text summary of all tool categories for the system prompt."""
+    lines = ["Available MCP tool categories (use `list_tool_categories` for details):"]
+    for category in TOOL_CATALOG.values():
+        tool_names = ", ".join(t.name for t in category.tools)
+        lines.append(f"- **{category.name}**: {category.description} [{tool_names}]")
+    return "\n".join(lines)