rossum-mcp 1.0.0__tar.gz → 1.1.0__tar.gz

{rossum_mcp-1.0.0/rossum_mcp.egg-info → rossum_mcp-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rossum-mcp
-Version: 1.0.0
+Version: 1.1.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
@@ -51,14 +51,14 @@ Dynamic: license-file
 
 <div align="center">
 
-**MCP server for AI-powered Rossum document processing. 56 tools for queues, schemas, hooks, engines, and more.**
+**MCP server for AI-powered Rossum document processing. 59 tools for queues, schemas, hooks, engines, and more.**
 
 [![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://stancld.github.io/rossum-agents/)
-[![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://www.python.org/downloads/)
+[![Python](https://img.shields.io/pypi/pyversions/rossum-mcp.svg)](https://pypi.org/project/rossum-mcp/)
 [![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-agents/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-agents)
-[![MCP Tools](https://img.shields.io/badge/MCP_Tools-56-blue.svg)](#available-tools)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-59-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/)
@@ -127,9 +127,29 @@ Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_c
 
 Set `ROSSUM_MCP_MODE=read-only` to disable all CREATE, UPDATE, and UPLOAD operations. Only GET and LIST operations will be available.
 
+### Runtime Mode Switching
+
+Two tools allow dynamic mode control:
+
+| Tool | Description |
+|------|-------------|
+| `get_mcp_mode` | Returns current operation mode (`read-only` or `read-write`) |
+| `set_mcp_mode` | Switches between modes at runtime |
+
+**Use case:** Start in read-only mode for safe exploration, then switch to read-write when ready to make changes.
+
+```
+User: What mode are we in?
+Assistant: [calls get_mcp_mode] → "read-only"
+
+User: I'm ready to update the schema now.
+Assistant: [calls set_mcp_mode("read-write")] → Mode switched to read-write
+           [calls update_schema(...)]
+```
+
 ## Available Tools
 
-The server provides **56 tools** organized into categories:
+The server provides **59 tools** organized into categories:
 
 | Category | Tools | Description |
 |----------|-------|-------------|
@@ -137,7 +157,7 @@ The server provides **56 tools** organized into categories:
 | **Queue Management** | 9 | Create, configure, delete, and list queues |
 | **Schema Management** | 8 | Define, modify, and delete field structures |
 | **Engine Management** | 6 | Configure extraction and splitting engines |
-| **Extensions & Rules** | 11 | Webhooks, serverless functions, business rules |
+| **Extensions & Rules** | 14 | Webhooks, serverless functions, business rules |
 | **Workspace Management** | 4 | Organize and delete workspaces |
 | **User Management** | 3 | List users and roles |
 | **Relations** | 4 | Annotation and document relations |
@@ -160,7 +180,7 @@ The server provides **56 tools** organized into categories:
 `get_engine`, `list_engines`, `create_engine`, `update_engine`, `create_engine_field`, `get_engine_fields`
 
 **Extensions & Rules:**
-`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `delete_rule`
+`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `create_rule`, `update_rule`, `patch_rule`, `delete_rule`
 
 **Workspace Management:**
 `get_workspace`, `list_workspaces`, `create_workspace`, `delete_workspace`

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/README.md

@@ -2,14 +2,14 @@
 
 <div align="center">
 
-**MCP server for AI-powered Rossum document processing. 56 tools for queues, schemas, hooks, engines, and more.**
+**MCP server for AI-powered Rossum document processing. 59 tools for queues, schemas, hooks, engines, and more.**
 
 [![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://stancld.github.io/rossum-agents/)
-[![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://www.python.org/downloads/)
+[![Python](https://img.shields.io/pypi/pyversions/rossum-mcp.svg)](https://pypi.org/project/rossum-mcp/)
 [![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-agents/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-agents)
-[![MCP Tools](https://img.shields.io/badge/MCP_Tools-56-blue.svg)](#available-tools)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-59-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/)
@@ -78,9 +78,29 @@ Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_c
 
 Set `ROSSUM_MCP_MODE=read-only` to disable all CREATE, UPDATE, and UPLOAD operations. Only GET and LIST operations will be available.
 
+### Runtime Mode Switching
+
+Two tools allow dynamic mode control:
+
+| Tool | Description |
+|------|-------------|
+| `get_mcp_mode` | Returns current operation mode (`read-only` or `read-write`) |
+| `set_mcp_mode` | Switches between modes at runtime |
+
+**Use case:** Start in read-only mode for safe exploration, then switch to read-write when ready to make changes.
+
+```
+User: What mode are we in?
+Assistant: [calls get_mcp_mode] → "read-only"
+
+User: I'm ready to update the schema now.
+Assistant: [calls set_mcp_mode("read-write")] → Mode switched to read-write
+           [calls update_schema(...)]
+```
+
 ## Available Tools
 
-The server provides **56 tools** organized into categories:
+The server provides **59 tools** organized into categories:
 
 | Category | Tools | Description |
 |----------|-------|-------------|
@@ -88,7 +108,7 @@ The server provides **56 tools** organized into categories:
 | **Queue Management** | 9 | Create, configure, delete, and list queues |
 | **Schema Management** | 8 | Define, modify, and delete field structures |
 | **Engine Management** | 6 | Configure extraction and splitting engines |
-| **Extensions & Rules** | 11 | Webhooks, serverless functions, business rules |
+| **Extensions & Rules** | 14 | Webhooks, serverless functions, business rules |
 | **Workspace Management** | 4 | Organize and delete workspaces |
 | **User Management** | 3 | List users and roles |
 | **Relations** | 4 | Annotation and document relations |
@@ -111,7 +131,7 @@ The server provides **56 tools** organized into categories:
 `get_engine`, `list_engines`, `create_engine`, `update_engine`, `create_engine_field`, `get_engine_fields`
 
 **Extensions & Rules:**
-`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `delete_rule`
+`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `create_rule`, `update_rule`, `patch_rule`, `delete_rule`
 
 **Workspace Management:**
 `get_workspace`, `list_workspaces`, `create_workspace`, `delete_workspace`

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rossum-mcp"
-version = "1.0.0"
+version = "1.1.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"

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/rossum_mcp/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/rossum_mcp/server.py

@@ -29,6 +29,7 @@ from rossum_mcp.tools import (
     register_user_tools,
     register_workspace_tools,
 )
+from rossum_mcp.tools.base import get_mcp_mode, set_mcp_mode
 
 setup_logging(app_name="rossum-mcp-server", log_level="DEBUG", use_console=False)
 
@@ -36,12 +37,8 @@ logger = logging.getLogger(__name__)
 
 BASE_URL = os.environ["ROSSUM_API_BASE_URL"].rstrip("/")
 API_TOKEN = os.environ["ROSSUM_API_TOKEN"]
-MODE = os.environ.get("ROSSUM_MCP_MODE", "read-write").lower()
 
-if MODE not in ("read-only", "read-write"):
-    raise ValueError(f"Invalid ROSSUM_MCP_MODE: {MODE}. Must be 'read-only' or 'read-write'")
-
-logger.info(f"Rossum MCP Server starting in {MODE} mode")
+logger.info(f"Rossum MCP Server starting in {get_mcp_mode()} mode")
 
 mcp = FastMCP("rossum-mcp-server")
 client = AsyncRossumAPIClient(base_url=BASE_URL, credentials=Token(token=API_TOKEN))
@@ -60,6 +57,22 @@ register_user_tools(mcp, client)
 register_workspace_tools(mcp, client)
 
 
+@mcp.tool(description="Get the current MCP operation mode (read-only or read-write).")
+async def get_mcp_mode_tool() -> dict:
+    return {"mode": get_mcp_mode()}
+
+
+@mcp.tool(
+    description="Set the MCP operation mode. Use 'read-only' to disable write operations, 'read-write' to enable them."
+)
+async def set_mcp_mode_tool(mode: str) -> dict:
+    try:
+        set_mcp_mode(mode)
+        return {"message": f"MCP mode set to '{get_mcp_mode()}'"}
+    except ValueError as e:
+        return {"error": str(e)}
+
+
 def main() -> None:
     """Main entry point for console script."""
     mcp.run()

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/rossum_mcp/tools/base.py

@@ -13,11 +13,30 @@ if TYPE_CHECKING:
 logger = logging.getLogger(__name__)
 
 BASE_URL = os.environ.get("ROSSUM_API_BASE_URL", "").rstrip("/")
-MODE = os.environ.get("ROSSUM_MCP_MODE", "read-write").lower()
 
 # Marker used to indicate omitted fields in list responses
 TRUNCATED_MARKER = "<omitted>"
 
+VALID_MODES = ("read-only", "read-write")
+
+_mcp_mode = os.environ.get("ROSSUM_MCP_MODE", "read-write").lower()
+if _mcp_mode not in VALID_MODES:
+    raise ValueError(f"Invalid ROSSUM_MCP_MODE: {_mcp_mode}. Must be one of: {VALID_MODES}")
+
+
+def get_mcp_mode() -> str:
+    """Return the current MCP mode."""
+    return _mcp_mode
+
+
+def set_mcp_mode(mode: str) -> None:
+    """Set the MCP mode (case-insensitive)."""
+    global _mcp_mode
+    normalized = mode.lower()
+    if normalized not in VALID_MODES:
+        raise ValueError(f"Invalid mode '{mode}'. Must be one of: {VALID_MODES}")
+    _mcp_mode = normalized
+
 
 def build_resource_url(resource_type: str, resource_id: int) -> str:
     """Build a full URL for a Rossum API resource."""
@@ -26,7 +45,7 @@ def build_resource_url(resource_type: str, resource_id: int) -> str:
 
 def is_read_write_mode() -> bool:
     """Check if server is in read-write mode."""
-    return MODE == "read-write"
+    return _mcp_mode == "read-write"
 
 
 def truncate_dict_fields(data: dict[str, Any], fields: tuple[str, ...]) -> dict[str, Any]:

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/rossum_mcp/tools/catalog.py

@@ -16,7 +16,7 @@ class ToolInfo:
 
     name: str
     description: str
-    destructive: bool = False
+    read_only: bool = True
 
 
 @dataclass
@@ -36,13 +36,13 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         name="annotations",
         description="Document processing: upload, retrieve, update, and confirm annotations",
         tools=[
-            ToolInfo("upload_document", "Upload document to queue"),
+            ToolInfo("upload_document", "Upload document to queue", read_only=False),
             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)"),
-            ToolInfo("delete_annotation", "Delete annotation (soft delete)", destructive=True),
+            ToolInfo("start_annotation", "Start annotation (to_review -> reviewing)", read_only=False),
+            ToolInfo("bulk_update_annotation_fields", "Bulk update annotation fields", read_only=False),
+            ToolInfo("confirm_annotation", "Confirm annotation (-> confirmed)", read_only=False),
+            ToolInfo("delete_annotation", "Delete annotation (soft delete)", read_only=False),
         ],
         keywords=["annotation", "document", "upload", "extract", "confirm", "review"],
     ),
@@ -54,11 +54,11 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
             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("create_queue", "Create a queue", read_only=False),
+            ToolInfo("update_queue", "Update queue settings", read_only=False),
             ToolInfo("get_queue_template_names", "List available queue templates"),
-            ToolInfo("create_queue_from_template", "Create queue from template"),
-            ToolInfo("delete_queue", "Delete queue (24h delayed)", destructive=True),
+            ToolInfo("create_queue_from_template", "Create queue from template", read_only=False),
+            ToolInfo("delete_queue", "Delete queue (24h delayed)", read_only=False),
         ],
         keywords=["queue", "inbox", "connector"],
     ),
@@ -68,12 +68,12 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         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("update_schema", "Update schema", read_only=False),
+            ToolInfo("create_schema", "Create new schema", read_only=False),
+            ToolInfo("patch_schema", "Add/update/remove schema fields", read_only=False),
             ToolInfo("get_schema_tree_structure", "Get lightweight schema tree"),
-            ToolInfo("prune_schema_fields", "Bulk remove schema fields"),
-            ToolInfo("delete_schema", "Delete schema", destructive=True),
+            ToolInfo("prune_schema_fields", "Bulk remove schema fields", read_only=False),
+            ToolInfo("delete_schema", "Delete schema", read_only=False),
         ],
         keywords=["schema", "field", "datapoint", "section", "multivalue", "tuple"],
     ),
@@ -83,9 +83,9 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         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("update_engine", "Update engine settings", read_only=False),
+            ToolInfo("create_engine", "Create new engine", read_only=False),
+            ToolInfo("create_engine_field", "Create engine field mapping", read_only=False),
             ToolInfo("get_engine_fields", "List engine fields"),
         ],
         keywords=["engine", "ai", "extractor", "splitter", "training"],
@@ -96,12 +96,12 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         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("create_hook", "Create new hook", read_only=False),
+            ToolInfo("update_hook", "Update hook configuration", read_only=False),
             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"),
-            ToolInfo("delete_hook", "Delete hook", destructive=True),
+            ToolInfo("create_hook_from_template", "Create hook from template", read_only=False),
+            ToolInfo("delete_hook", "Delete hook", read_only=False),
         ],
         keywords=["hook", "extension", "webhook", "automation", "function", "serverless"],
     ),
@@ -111,7 +111,7 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         tools=[
             ToolInfo("get_email_template", "Retrieve email template"),
             ToolInfo("list_email_templates", "List email templates"),
-            ToolInfo("create_email_template", "Create email template"),
+            ToolInfo("create_email_template", "Create email template", read_only=False),
         ],
         keywords=["email", "template", "notification", "rejection"],
     ),
@@ -139,7 +139,10 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         tools=[
             ToolInfo("get_rule", "Retrieve rule details"),
             ToolInfo("list_rules", "List validation rules"),
-            ToolInfo("delete_rule", "Delete rule", destructive=True),
+            ToolInfo("create_rule", "Create validation rule", read_only=False),
+            ToolInfo("update_rule", "Full update rule (PUT)", read_only=False),
+            ToolInfo("patch_rule", "Partial update rule (PATCH)", read_only=False),
+            ToolInfo("delete_rule", "Delete rule", read_only=False),
         ],
         keywords=["rule", "validation", "constraint"],
     ),
@@ -159,8 +162,8 @@ TOOL_CATALOG: dict[str, ToolCategory] = {
         tools=[
             ToolInfo("get_workspace", "Retrieve workspace details"),
             ToolInfo("list_workspaces", "List all workspaces"),
-            ToolInfo("create_workspace", "Create new workspace"),
-            ToolInfo("delete_workspace", "Delete workspace", destructive=True),
+            ToolInfo("create_workspace", "Create new workspace", read_only=False),
+            ToolInfo("delete_workspace", "Delete workspace", read_only=False),
         ],
         keywords=["workspace", "organization"],
     ),

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/rossum_mcp/tools/discovery.py

@@ -21,8 +21,8 @@ def register_discovery_tools(mcp: FastMCP) -> None:
     @mcp.tool(
         description="List all available tool categories with descriptions, tool names, and keywords. "
         "Use this to discover what tools are available, then use load_tool_category to load "
-        "tools from specific categories before using them. Tools with destructive=true require "
-        "explicit user request to use (delete operations)."
+        "tools from specific categories before using them. Tools with read_only=false are write "
+        "operations (create, update, delete)."
     )
     async def list_tool_categories() -> list[dict]:
         return [

rossum_mcp-1.1.0/rossum_mcp/tools/rules.py

@@ -0,0 +1,241 @@
+"""Rule tools for Rossum MCP Server."""
+
+from __future__ import annotations
+
+import logging
+from typing import TYPE_CHECKING, Literal, TypedDict
+
+from rossum_api.domain_logic.resources import Resource
+from rossum_api.models.rule import Rule
+
+from rossum_mcp.tools.base import build_resource_url, delete_resource, is_read_write_mode
+
+if TYPE_CHECKING:
+    from fastmcp import FastMCP
+    from rossum_api import AsyncRossumAPIClient
+
+logger = logging.getLogger(__name__)
+
+
+RuleActionType = Literal[
+    "show_message",
+    "add_automation_blocker",
+    "add_validation_source",
+    "change_queue",
+    "send_email",
+    "hide_field",
+    "show_field",
+    "show_hide_field",
+    "change_status",
+    "add_label",
+    "remove_label",
+    "custom",
+]
+
+
+class RuleActionPayload(TypedDict, total=False):
+    """Payload for rule actions. Fields depend on action type."""
+
+    type: Literal["info", "warning", "error"]  # for show_message
+    content: str  # message content or template
+    schema_id: str  # target field schema_id
+    queue_url: str  # for change_queue
+    status: str  # for change_status
+    label: str  # for add_label/remove_label
+
+
+class RuleAction(TypedDict):
+    """Rule action definition."""
+
+    id: str  # unique action identifier
+    type: RuleActionType
+    event: Literal["validation"]
+    payload: RuleActionPayload
+
+
+async def _get_rule(client: AsyncRossumAPIClient, rule_id: int) -> Rule:
+    logger.debug(f"Retrieving rule: rule_id={rule_id}")
+    rule: Rule = await client.retrieve_rule(rule_id)
+    return rule
+
+
+async def _list_rules(
+    client: AsyncRossumAPIClient,
+    schema_id: int | None = None,
+    organization_id: int | None = None,
+    enabled: bool | None = None,
+) -> list[Rule]:
+    logger.debug(f"Listing rules: schema_id={schema_id}, organization_id={organization_id}, enabled={enabled}")
+    filters: dict = {}
+    if schema_id is not None:
+        filters["schema"] = schema_id
+    if organization_id is not None:
+        filters["organization"] = organization_id
+    if enabled is not None:
+        filters["enabled"] = enabled
+
+    rules_list: list[Rule] = [rule async for rule in client.list_rules(**filters)]
+    return rules_list
+
+
+async def _create_rule(
+    client: AsyncRossumAPIClient,
+    name: str,
+    schema_id: int,
+    trigger_condition: str,
+    actions: list[RuleAction],
+    enabled: bool = True,
+    queue_ids: list[int] | None = None,
+) -> Rule | dict:
+    if not is_read_write_mode():
+        return {"error": "create_rule is not available in read-only mode"}
+
+    schema_url = build_resource_url("schemas", schema_id)
+    logger.info(f"Creating rule: name={name}, schema_id={schema_id}, enabled={enabled}")
+
+    rule_data: dict = {
+        "name": name,
+        "schema": schema_url,
+        "trigger_condition": trigger_condition,
+        "actions": actions,
+        "enabled": enabled,
+    }
+
+    if queue_ids is not None:
+        rule_data["queues"] = [build_resource_url("queues", qid) for qid in queue_ids]
+
+    logger.debug(f"Rule creation payload: {rule_data}")
+    rule: Rule = await client.create_new_rule(rule_data)
+    logger.info(f"Successfully created rule: id={rule.id}, name={rule.name}")
+    return rule
+
+
+async def _update_rule(
+    client: AsyncRossumAPIClient,
+    rule_id: int,
+    name: str,
+    trigger_condition: str,
+    actions: list[RuleAction],
+    enabled: bool,
+    queue_ids: list[int] | None = None,
+) -> Rule | dict:
+    """Full update (PUT) - all fields required."""
+    if not is_read_write_mode():
+        return {"error": "update_rule is not available in read-only mode"}
+
+    logger.info(f"Updating rule: rule_id={rule_id}, name={name}")
+    existing_rule: Rule = await client.retrieve_rule(rule_id)
+
+    rule_data: dict = {
+        "name": name,
+        "schema": existing_rule.schema,
+        "trigger_condition": trigger_condition,
+        "actions": actions,
+        "enabled": enabled,
+    }
+
+    if queue_ids is not None:
+        rule_data["queues"] = [build_resource_url("queues", qid) for qid in queue_ids]
+
+    logger.debug(f"Rule update payload: {rule_data}")
+    await client._http_client.update(Resource.Rule, rule_id, rule_data)
+    updated_rule: Rule = await client.retrieve_rule(rule_id)
+    logger.info(f"Successfully updated rule: id={updated_rule.id}")
+    return updated_rule
+
+
+async def _patch_rule(
+    client: AsyncRossumAPIClient,
+    rule_id: int,
+    name: str | None = None,
+    trigger_condition: str | None = None,
+    actions: list[RuleAction] | None = None,
+    enabled: bool | None = None,
+    queue_ids: list[int] | None = None,
+) -> Rule | dict:
+    """Partial update (PATCH) - only provided fields are updated."""
+    if not is_read_write_mode():
+        return {"error": "patch_rule is not available in read-only mode"}
+
+    logger.info(f"Patching rule: rule_id={rule_id}")
+
+    patch_data: dict = {}
+    if name is not None:
+        patch_data["name"] = name
+    if trigger_condition is not None:
+        patch_data["trigger_condition"] = trigger_condition
+    if actions is not None:
+        patch_data["actions"] = actions
+    if enabled is not None:
+        patch_data["enabled"] = enabled
+    if queue_ids is not None:
+        patch_data["queues"] = [build_resource_url("queues", qid) for qid in queue_ids]
+
+    if not patch_data:
+        return {"error": "No fields provided to update"}
+
+    logger.debug(f"Rule patch payload: {patch_data}")
+    updated_rule: Rule = await client.update_part_rule(rule_id, patch_data)
+    logger.info(f"Successfully patched rule: id={updated_rule.id}")
+    return updated_rule
+
+
+async def _delete_rule(client: AsyncRossumAPIClient, rule_id: int) -> dict:
+    return await delete_resource("rule", rule_id, client.delete_rule)
+
+
+def register_rule_tools(mcp: FastMCP, client: AsyncRossumAPIClient) -> None:
+    """Register rule-related tools with the FastMCP server."""
+
+    @mcp.tool(description="Retrieve rule details.")
+    async def get_rule(rule_id: int) -> Rule:
+        return await _get_rule(client, rule_id)
+
+    @mcp.tool(description="List all rules.")
+    async def list_rules(
+        schema_id: int | None = None, organization_id: int | None = None, enabled: bool | None = None
+    ) -> list[Rule]:
+        return await _list_rules(client, schema_id, organization_id, enabled)
+
+    @mcp.tool(
+        description="Create a new rule. Rules automate field operations based on trigger conditions (TxScript formulas like 'field.amount > 1000'). Actions require: id (unique str), type (show_message|hide_field|show_field|change_status|custom|etc), event (validation), payload (dict with type, content, schema_id for show_message). queue_ids limits rule to specific queues."
+    )
+    async def create_rule(
+        name: str,
+        schema_id: int,
+        trigger_condition: str,
+        actions: list[RuleAction],
+        enabled: bool = True,
+        queue_ids: list[int] | None = None,
+    ) -> Rule | dict:
+        return await _create_rule(client, name, schema_id, trigger_condition, actions, enabled, queue_ids)
+
+    @mcp.tool(
+        description="Full update of a rule (PUT). All fields required. Use patch_rule for partial updates. queue_ids limits rule to specific queues."
+    )
+    async def update_rule(
+        rule_id: int,
+        name: str,
+        trigger_condition: str,
+        actions: list[RuleAction],
+        enabled: bool,
+        queue_ids: list[int] | None = None,
+    ) -> Rule | dict:
+        return await _update_rule(client, rule_id, name, trigger_condition, actions, enabled, queue_ids)
+
+    @mcp.tool(
+        description="Partial update of a rule (PATCH). Only provided fields are updated. queue_ids limits rule to specific queues (empty list removes all)."
+    )
+    async def patch_rule(
+        rule_id: int,
+        name: str | None = None,
+        trigger_condition: str | None = None,
+        actions: list[RuleAction] | None = None,
+        enabled: bool | None = None,
+        queue_ids: list[int] | None = None,
+    ) -> Rule | dict:
+        return await _patch_rule(client, rule_id, name, trigger_condition, actions, enabled, queue_ids)
+
+    @mcp.tool(description="Delete a rule.")
+    async def delete_rule(rule_id: int) -> dict:
+        return await _delete_rule(client, rule_id)

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0/rossum_mcp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rossum-mcp
-Version: 1.0.0
+Version: 1.1.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
@@ -51,14 +51,14 @@ Dynamic: license-file
 
 <div align="center">
 
-**MCP server for AI-powered Rossum document processing. 56 tools for queues, schemas, hooks, engines, and more.**
+**MCP server for AI-powered Rossum document processing. 59 tools for queues, schemas, hooks, engines, and more.**
 
 [![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://stancld.github.io/rossum-agents/)
-[![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://www.python.org/downloads/)
+[![Python](https://img.shields.io/pypi/pyversions/rossum-mcp.svg)](https://pypi.org/project/rossum-mcp/)
 [![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-agents/branch/master/graph/badge.svg?flag=rossum-mcp)](https://codecov.io/gh/stancld/rossum-agents)
-[![MCP Tools](https://img.shields.io/badge/MCP_Tools-56-blue.svg)](#available-tools)
+[![MCP Tools](https://img.shields.io/badge/MCP_Tools-59-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/)
@@ -127,9 +127,29 @@ Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_c
 
 Set `ROSSUM_MCP_MODE=read-only` to disable all CREATE, UPDATE, and UPLOAD operations. Only GET and LIST operations will be available.
 
+### Runtime Mode Switching
+
+Two tools allow dynamic mode control:
+
+| Tool | Description |
+|------|-------------|
+| `get_mcp_mode` | Returns current operation mode (`read-only` or `read-write`) |
+| `set_mcp_mode` | Switches between modes at runtime |
+
+**Use case:** Start in read-only mode for safe exploration, then switch to read-write when ready to make changes.
+
+```
+User: What mode are we in?
+Assistant: [calls get_mcp_mode] → "read-only"
+
+User: I'm ready to update the schema now.
+Assistant: [calls set_mcp_mode("read-write")] → Mode switched to read-write
+           [calls update_schema(...)]
+```
+
 ## Available Tools
 
-The server provides **56 tools** organized into categories:
+The server provides **59 tools** organized into categories:
 
 | Category | Tools | Description |
 |----------|-------|-------------|
@@ -137,7 +157,7 @@ The server provides **56 tools** organized into categories:
 | **Queue Management** | 9 | Create, configure, delete, and list queues |
 | **Schema Management** | 8 | Define, modify, and delete field structures |
 | **Engine Management** | 6 | Configure extraction and splitting engines |
-| **Extensions & Rules** | 11 | Webhooks, serverless functions, business rules |
+| **Extensions & Rules** | 14 | Webhooks, serverless functions, business rules |
 | **Workspace Management** | 4 | Organize and delete workspaces |
 | **User Management** | 3 | List users and roles |
 | **Relations** | 4 | Annotation and document relations |
@@ -160,7 +180,7 @@ The server provides **56 tools** organized into categories:
 `get_engine`, `list_engines`, `create_engine`, `update_engine`, `create_engine_field`, `get_engine_fields`
 
 **Extensions & Rules:**
-`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `delete_rule`
+`get_hook`, `list_hooks`, `create_hook`, `update_hook`, `list_hook_templates`, `create_hook_from_template`, `list_hook_logs`, `delete_hook`, `get_rule`, `list_rules`, `create_rule`, `update_rule`, `patch_rule`, `delete_rule`
 
 **Workspace Management:**
 `get_workspace`, `list_workspaces`, `create_workspace`, `delete_workspace`

{rossum_mcp-1.0.0 → rossum_mcp-1.1.0}/tests/test_catalog.py

@@ -69,19 +69,41 @@ class TestToolCatalog:
         }
         assert tool_names == expected
 
-    def test_destructive_tools_are_marked(self) -> None:
-        destructive_tools = [
-            (cat_name, t.name) for cat_name, cat in TOOL_CATALOG.items() for t in cat.tools if t.destructive
+    def test_write_tools_are_marked(self) -> None:
+        write_tools = [
+            (cat_name, t.name) for cat_name, cat in TOOL_CATALOG.items() for t in cat.tools if not t.read_only
         ]
-        expected_destructive = {
+        expected_write = {
+            ("annotations", "upload_document"),
+            ("annotations", "start_annotation"),
+            ("annotations", "bulk_update_annotation_fields"),
+            ("annotations", "confirm_annotation"),
             ("annotations", "delete_annotation"),
+            ("queues", "create_queue"),
+            ("queues", "update_queue"),
+            ("queues", "create_queue_from_template"),
             ("queues", "delete_queue"),
+            ("schemas", "update_schema"),
+            ("schemas", "create_schema"),
+            ("schemas", "patch_schema"),
+            ("schemas", "prune_schema_fields"),
             ("schemas", "delete_schema"),
+            ("engines", "update_engine"),
+            ("engines", "create_engine"),
+            ("engines", "create_engine_field"),
+            ("hooks", "create_hook"),
+            ("hooks", "update_hook"),
+            ("hooks", "create_hook_from_template"),
             ("hooks", "delete_hook"),
+            ("email_templates", "create_email_template"),
+            ("rules", "create_rule"),
+            ("rules", "update_rule"),
+            ("rules", "patch_rule"),
             ("rules", "delete_rule"),
+            ("workspaces", "create_workspace"),
             ("workspaces", "delete_workspace"),
         }
-        assert set(destructive_tools) == expected_destructive
+        assert set(write_tools) == expected_write
 
 
 class TestCatalogSummary:

rossum_mcp-1.0.0/rossum_mcp/tools/rules.py

@@ -1,63 +0,0 @@
-"""Rule tools for Rossum MCP Server."""
-
-from __future__ import annotations
-
-import logging
-from typing import TYPE_CHECKING
-
-from rossum_api.models.rule import Rule
-
-from rossum_mcp.tools.base import delete_resource
-
-if TYPE_CHECKING:
-    from fastmcp import FastMCP
-    from rossum_api import AsyncRossumAPIClient
-
-logger = logging.getLogger(__name__)
-
-
-async def _get_rule(client: AsyncRossumAPIClient, rule_id: int) -> Rule:
-    logger.debug(f"Retrieving rule: rule_id={rule_id}")
-    rule: Rule = await client.retrieve_rule(rule_id)
-    return rule
-
-
-async def _list_rules(
-    client: AsyncRossumAPIClient,
-    schema_id: int | None = None,
-    organization_id: int | None = None,
-    enabled: bool | None = None,
-) -> list[Rule]:
-    logger.debug(f"Listing rules: schema_id={schema_id}, organization_id={organization_id}, enabled={enabled}")
-    filters: dict = {}
-    if schema_id is not None:
-        filters["schema"] = schema_id
-    if organization_id is not None:
-        filters["organization"] = organization_id
-    if enabled is not None:
-        filters["enabled"] = enabled
-
-    rules_list: list[Rule] = [rule async for rule in client.list_rules(**filters)]
-    return rules_list
-
-
-async def _delete_rule(client: AsyncRossumAPIClient, rule_id: int) -> dict:
-    return await delete_resource("rule", rule_id, client.delete_rule)
-
-
-def register_rule_tools(mcp: FastMCP, client: AsyncRossumAPIClient) -> None:
-    """Register rule-related tools with the FastMCP server."""
-
-    @mcp.tool(description="Retrieve rule details.")
-    async def get_rule(rule_id: int) -> Rule:
-        return await _get_rule(client, rule_id)
-
-    @mcp.tool(description="List all rules.")
-    async def list_rules(
-        schema_id: int | None = None, organization_id: int | None = None, enabled: bool | None = None
-    ) -> list[Rule]:
-        return await _list_rules(client, schema_id, organization_id, enabled)
-
-    @mcp.tool(description="Delete a rule.")
-    async def delete_rule(rule_id: int) -> dict:
-        return await _delete_rule(client, rule_id)