@zudello/mcp 1.1.2

package/TOOL_CATALOG.md

@@ -0,0 +1,1025 @@
+# Zudello MCP Server - Complete Tool Catalog
+
+Comprehensive reference guide for all 106 Zudello tools available through the MCP server.
+
+## Tool Categories
+
+- [Core Operations](#core-operations) - 3 tools
+- [Model Discovery](#model-discovery) - 5 tools
+- [Configuration Management](#configuration-management) - 5 tools
+- [Resource Operations](#resource-operations) - 2 tools
+- [Automation Rules - Sentences](#automation-rules---sentences) - 8 tools
+- [History](#history) - 1 tool
+- [Automation System](#automation-system) - 10 tools
+- [Connections](#connections) - 5 tools
+- [Trigger & Sync Control](#trigger--sync-control) - 2 tools
+- [Bulk Operations](#bulk-operations) - 2 tools
+- [Approval Workflows](#approval-workflows) - 1 tool
+- [Users & Groups](#users--groups) - 2 tools
+- [Datasets](#datasets) - 4 tools
+- [Field Settings](#field-settings) - 4 tools
+- [Quick Actions](#quick-actions) - 5 tools
+- [Export Templates](#export-templates) - 7 tools
+- [Document Types](#document-types) - 5 tools
+- [Organization Admin](#organization-admin) - 9 tools
+- [Notifications](#notifications) - 3 tools
+- [Exception Reasons](#exception-reasons) - 6 tools
+- [Language Placeholders](#language-placeholders) - 2 tools
+- [Inbox Management](#inbox-management) - 8 tools
+- [Document Context](#document-context) - 2 tools
+- [Document Statuses](#document-statuses) - 5 tools
+
+---
+
+## Core Operations
+
+### `zudelloSearch`
+**Type**: Read-only
+**Description**: Search and filter resources with complex queries
+**Use Cases**:
+- Find invoices by date range, status, or supplier
+- Search purchase orders with custom filters
+- Query claims by user or approval status
+
+**Key Parameters**:
+- `model`: Model name (e.g., "invoice", "purchase_order")
+- `filter`: Complex filter object with field conditions
+- `select`: Array of fields to return
+- `limit`, `offset`: Pagination
+- `order_by`: Sorting configuration
+
+### `zudelloFetch`
+**Type**: Read-only
+**Description**: Fetch single resource by UUID or external ID
+**Use Cases**:
+- Retrieve specific invoice details
+- Get complete purchase order information
+- Fetch document by external reference
+
+**Key Parameters**:
+- `uuid`: Resource UUID
+- `externalId`: External reference ID (alternative to UUID)
+- `model`: Model type (optional with UUID)
+
+### `zudelloPushMessage`
+**Type**: Write (Low Risk)
+**Description**: Load Zudello data proactively into conversation context
+**Use Cases**:
+- Initialize conversation with relevant transaction data
+- Load supplier/customer context for discussions
+- Provide context for pending approvals
+
+**Key Parameters**:
+- `operation`: Object with `type` ("fetch" or "search") and relevant params
+- `context_message`: Human-readable explanation of loaded data
+- `silent`: Boolean to suppress display message
+
+---
+
+## Model Discovery
+
+### `zudelloListModels`
+**Type**: Read-only
+**Description**: List all available data models in Zudello
+**Use Cases**:
+- Discover available data types
+- Explore ERP schema
+- Build dynamic queries
+
+### `zudelloGetModelMetadata`
+**Type**: Read-only
+**Description**: Get display names, icons, and UI metadata for a model
+**Use Cases**:
+- Build user-friendly interfaces
+- Get localized model names
+- Retrieve icon configurations
+
+**Key Parameters**:
+- `model`: Model name
+
+### `zudelloGetModelSchema`
+**Type**: Read-only
+**Description**: Get complete field definitions and types for a model
+**Use Cases**:
+- Understand data structure
+- Build validation logic
+- Generate forms dynamically
+
+**Key Parameters**:
+- `model`: Model name
+
+### `zudelloGetModelRelations`
+**Type**: Read-only
+**Description**: Discover relationships between models
+**Use Cases**:
+- Understand data connections
+- Build complex queries with joins
+- Navigate related data
+
+**Key Parameters**:
+- `model`: Model name
+
+### `zudelloGetFieldMetadata`
+**Type**: Read-only
+**Description**: Get detailed metadata for specific fields
+**Use Cases**:
+- Get field validation rules
+- Retrieve field descriptions
+- Understand field constraints
+
+**Key Parameters**:
+- `model`: Model name
+- `field`: Field name
+
+---
+
+## Configuration Management
+
+### `zudelloListConfigs`
+**Type**: Read-only
+**Description**: List all configurations for a context
+**Use Cases**:
+- Browse available configurations
+- Audit configuration settings
+- Export configuration lists
+
+**Key Parameters**:
+- `configType`: Configuration type (e.g., "supplier_category")
+- `context`: Context filter object
+
+### `zudelloGetConfig`
+**Type**: Read-only
+**Description**: Retrieve single configuration by UUID
+**Key Parameters**:
+- `uuid`: Configuration UUID
+
+### `zudelloCreateConfig`
+**Type**: Write (Medium Risk)
+**Description**: Create new configuration entry
+**Requires Approval**: Yes
+**Key Parameters**:
+- `configType`: Type of configuration
+- `payload`: Configuration data
+- `context`: Context object
+
+### `zudelloUpdateConfig`
+**Type**: Write (High Risk)
+**Description**: Update existing configuration
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Configuration UUID
+- `configType`: Type of configuration
+- `payload`: Updated data
+- `context`: Context object
+
+### `zudelloUpdateConfigsOrder`
+**Type**: Write (Low Risk)
+**Description**: Reorder configurations for display
+**Requires Approval**: Yes
+**Key Parameters**:
+- `configOrders`: Array of {uuid, order} objects
+
+---
+
+## Resource Operations
+
+### `zudelloGetResources`
+**Type**: Read-only
+**Description**: Batch fetch multiple resources by UUIDs
+**Use Cases**:
+- Retrieve related resources efficiently
+- Bulk data loading
+- Populate dashboards
+
+**Key Parameters**:
+- `uuids`: Array of resource UUIDs
+
+### `zudelloUpdateOrCreateResources`
+**Type**: Write (High Risk)
+**Description**: Batch upsert operation for resources
+**Requires Approval**: Yes
+**Use Cases**:
+- Bulk import from external systems
+- Mass update operations
+- Synchronization workflows
+
+**Key Parameters**:
+- `resources`: Array of resource objects with data
+- `model`: Target model type
+
+---
+
+## Automation Rules - Sentences
+
+### `zudelloListSentences`
+**Type**: Read-only
+**Description**: List automation rules for a context
+**Key Parameters**:
+- `context`: Context filter object
+- `includePaths`: Optional field selection
+
+### `zudelloGetSentence`
+**Type**: Read-only
+**Description**: Get single automation rule details
+**Key Parameters**:
+- `uuid`: Sentence UUID
+
+### `zudelloGetSentenceTemplate`
+**Type**: Read-only
+**Description**: Get automation rule template structure
+**Key Parameters**:
+- `uuid`: Template UUID
+
+### `zudelloListSentenceTemplates`
+**Type**: Read-only
+**Description**: List available automation rule templates
+
+### `zudelloListSentenceResources`
+**Type**: Read-only
+**Description**: List resources associated with sentences
+**Key Parameters**:
+- `context`: Context filter
+
+### `zudelloCreateSentence`
+**Type**: Write (Medium Risk)
+**Description**: Create new automation rule
+**Requires Approval**: Yes
+**Key Parameters**:
+- `template_uuid`: Template to use
+- `payload`: Rule configuration
+- `context`: Application context
+
+### `zudelloUpdateSentence`
+**Type**: Write (High Risk)
+**Description**: Update existing automation rule
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Sentence UUID
+- `payload`: Updated configuration
+- `context`: Application context
+
+### `zudelloUpdateSentencesOrder`
+**Type**: Write (Low Risk)
+**Description**: Reorder automation rules
+**Requires Approval**: Yes
+**Key Parameters**:
+- `sentenceOrders`: Array of {uuid, order} objects
+
+---
+
+## History
+
+### `zudelloGetHistory`
+**Type**: Read-only
+**Description**: View audit trail and change history for resources
+**Use Cases**:
+- Audit compliance
+- Track changes over time
+- Investigation and troubleshooting
+
+**Key Parameters**:
+- `resource_uuid`: Resource to view history for
+- `limit`, `offset`: Pagination
+
+---
+
+## Automation System
+
+### Scripts
+
+#### `zudelloListScripts`
+**Type**: Read-only
+**Description**: List integration scripts
+**Key Parameters**:
+- `integration_uuid`: Filter by integration (optional)
+
+#### `zudelloGetScript`
+**Type**: Read-only
+**Description**: Get single script details
+**Key Parameters**:
+- `uuid`: Script UUID
+
+#### `zudelloListGlobalIntegrations`
+**Type**: Read-only
+**Description**: List all available global integrations
+
+#### `zudelloListGlobalScriptsForIntegration`
+**Type**: Read-only
+**Description**: List global scripts for a specific integration
+**Key Parameters**:
+- `integration_uuid`: Integration UUID
+
+### Triggers
+
+#### `zudelloListTriggers`
+**Type**: Read-only
+**Description**: List all automation triggers
+**Key Parameters**:
+- `script_uuid`: Filter by script (optional)
+
+#### `zudelloGetTrigger`
+**Type**: Read-only
+**Description**: Get single trigger details
+**Key Parameters**:
+- `uuid`: Trigger UUID
+
+### Logs
+
+#### `zudelloGetAutomationLogs`
+**Type**: Read-only
+**Description**: View automation execution logs
+**Key Parameters**:
+- `trigger_uuid`: Trigger to view logs for
+- `limit`, `offset`: Pagination
+
+#### `zudelloGetRunLogs`
+**Type**: Read-only
+**Description**: Get detailed run logs for a trigger
+**Key Parameters**:
+- `trigger_uuid`: Trigger UUID
+- `limit`, `offset`: Pagination
+
+#### `zudelloGetRunLogsContent`
+**Type**: Read-only
+**Description**: Get full content of run logs
+**Key Parameters**:
+- `run_uuid`: Run UUID
+
+#### `zudelloSearchRuns`
+**Type**: Read-only
+**Description**: Search automation runs with filters
+**Key Parameters**:
+- `trigger_uuid`: Trigger UUID
+- `filter`: Search criteria
+
+---
+
+## Connections
+
+### `zudelloListConnections`
+**Type**: Read-only
+**Description**: List all integration connections
+**Use Cases**:
+- View configured integrations
+- Check connection status
+- Audit integrations
+
+### `zudelloCheckConnectionStatus`
+**Type**: Read-only
+**Description**: Check health status of a connection
+**Key Parameters**:
+- `connection_uuid`: Connection UUID
+
+### `zudelloReconnect`
+**Type**: Write (Medium Risk)
+**Description**: Reconnect a disconnected integration
+**Requires Approval**: Yes
+**Key Parameters**:
+- `connection_uuid`: Connection UUID
+
+### `zudelloListAvailableIntegrations`
+**Type**: Read-only
+**Description**: List all available integration types
+
+### `zudelloGetConnectionTemplate`
+**Type**: Read-only
+**Description**: Get connection configuration template
+**Key Parameters**:
+- `integration_uuid`: Integration type UUID
+
+---
+
+## Trigger & Sync Control
+
+### `zudelloSetTriggerEnabled`
+**Type**: Write (High Risk)
+**Description**: Enable or disable automation triggers
+**Requires Approval**: Yes
+**Use Cases**:
+- Temporarily disable problematic automations
+- Enable new automation rules
+- Troubleshooting automation issues
+
+**Key Parameters**:
+- `trigger_uuid`: Trigger UUID
+- `enabled`: Boolean enabled state
+
+### `zudelloInitiateSync`
+**Type**: Write (High Risk)
+**Description**: Manually trigger a data synchronization
+**Requires Approval**: Yes
+**Use Cases**:
+- Force immediate sync
+- Recover from sync failures
+- Test integration connections
+
+**Key Parameters**:
+- `sync_uuid`: Sync configuration UUID
+
+---
+
+## Bulk Operations
+
+### `zudelloBulkApproveMilestones`
+**Type**: Write (High Risk)
+**Description**: Approve or reject multiple workflow milestones
+**Requires Approval**: Yes
+**Key Parameters**:
+- `milestone_uuids`: Array of milestone UUIDs
+- `action`: "approve" or "reject"
+- `comment`: Optional comment
+
+### `zudelloBulkSendReminders`
+**Type**: Write (Medium Risk)
+**Description**: Send reminder notifications in bulk
+**Requires Approval**: Yes
+**Key Parameters**:
+- `milestone_uuids`: Array of milestone UUIDs
+
+---
+
+## Approval Workflows
+
+### `zudelloGetApprovalFlows`
+**Type**: Read-only
+**Description**: View approval workflow configurations
+**Use Cases**:
+- Understand approval requirements
+- Audit approval processes
+- Build approval dashboards
+
+**Key Parameters**:
+- `context`: Context filter (optional)
+
+---
+
+## Users & Groups
+
+### `zudelloGetUserGroups`
+**Type**: Read-only
+**Description**: Get user groups for permissions
+**Use Cases**:
+- Understand permission structure
+- Assign users to groups
+- Audit access controls
+
+### `zudelloGetUsers`
+**Type**: Read-only
+**Description**: Get team users list
+**Use Cases**:
+- User directory lookups
+- Assignment workflows
+- Reporting on team structure
+
+---
+
+## Datasets
+
+### `zudelloListDatasets`
+**Type**: Read-only
+**Description**: List all custom datasets
+
+### `zudelloGetDataset`
+**Type**: Read-only
+**Description**: Get single dataset details
+**Key Parameters**:
+- `uuid`: Dataset UUID
+
+### `zudelloCreateDataset`
+**Type**: Write (Medium Risk)
+**Description**: Create new custom dataset
+**Requires Approval**: Yes
+**Key Parameters**:
+- `name`: Dataset name
+- `description`: Description
+- `fields`: Field definitions
+
+### `zudelloUpdateDataset`
+**Type**: Write (High Risk)
+**Description**: Update existing dataset
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Dataset UUID
+- `name`, `description`, `fields`: Updated values
+
+---
+
+## Field Settings
+
+### `zudelloListFields`
+**Type**: Read-only
+**Description**: List field configurations for a model
+**Key Parameters**:
+- `model`: Model name
+
+### `zudelloGetField`
+**Type**: Read-only
+**Description**: Get field configuration details
+**Key Parameters**:
+- `uuid`: Field configuration UUID
+
+### `zudelloCreateField`
+**Type**: Write (Medium Risk)
+**Description**: Create custom field configuration
+**Requires Approval**: Yes
+**Key Parameters**:
+- `model`: Target model
+- `field_config`: Field definition
+
+### `zudelloUpdateField`
+**Type**: Write (High Risk)
+**Description**: Update field configuration
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Field UUID
+- `field_config`: Updated definition
+
+---
+
+## Quick Actions
+
+### `zudelloListQuickActions`
+**Type**: Read-only
+**Description**: List available quick actions
+
+### `zudelloGetQuickAction`
+**Type**: Read-only
+**Description**: Get quick action details
+**Key Parameters**:
+- `uuid`: Quick action UUID
+
+### `zudelloCreateQuickAction`
+**Type**: Write (Medium Risk)
+**Description**: Create new quick action
+**Requires Approval**: Yes
+**Key Parameters**:
+- `name`: Action name
+- `action_config`: Action configuration
+
+### `zudelloUpdateQuickAction`
+**Type**: Write (High Risk)
+**Description**: Update existing quick action
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Quick action UUID
+- `action_config`: Updated configuration
+
+### `zudelloTriggerQuickAction`
+**Type**: Write (High Risk)
+**Description**: Execute a quick action
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Quick action UUID
+- `resource_uuids`: Target resources
+
+---
+
+## Export Templates
+
+### `zudelloListExportTemplates`
+**Type**: Read-only
+**Description**: List all export templates
+
+### `zudelloGetExportTemplate`
+**Type**: Read-only
+**Description**: Get export template details
+**Key Parameters**:
+- `uuid`: Template UUID
+
+### `zudelloCreateExportTemplate`
+**Type**: Write (Medium Risk)
+**Description**: Create new export template
+**Requires Approval**: Yes
+**Key Parameters**:
+- `name`: Template name
+- `template_config`: Export configuration
+
+### `zudelloUpdateExportTemplate`
+**Type**: Write (High Risk)
+**Description**: Update export template
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Template UUID
+- `template_config`: Updated configuration
+
+### `zudelloRunExport`
+**Type**: Write (Low Risk)
+**Description**: Execute an export operation
+**Requires Approval**: Yes
+**Key Parameters**:
+- `template_uuid`: Template to use
+- `filter`: Export filter criteria
+
+### `zudelloListExports`
+**Type**: Read-only
+**Description**: List completed exports
+
+### `zudelloGetExportDownloadUrl`
+**Type**: Read-only
+**Description**: Get download URL for completed export
+**Key Parameters**:
+- `export_uuid`: Export UUID
+
+---
+
+## Document Types
+
+### `zudelloListDocumentTypes`
+**Type**: Read-only
+**Description**: List all document types
+
+### `zudelloGetDocumentType`
+**Type**: Read-only
+**Description**: Get document type details
+**Key Parameters**:
+- `uuid`: Document type UUID
+
+### `zudelloGetMergedFormMetadata`
+**Type**: Read-only
+**Description**: Get complete form metadata for document type
+**Key Parameters**:
+- `uuid`: Document type UUID
+
+### `zudelloCreateDocumentType`
+**Type**: Write (Medium Risk)
+**Description**: Create new document type
+**Requires Approval**: Yes
+**Key Parameters**:
+- `name`: Document type name
+- `type_config`: Type configuration
+
+### `zudelloUpdateDocumentType`
+**Type**: Write (High Risk)
+**Description**: Update document type
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Document type UUID
+- `type_config`: Updated configuration
+
+---
+
+## Organization Admin
+
+**Note**: These tools require organization admin or Zudello staff privileges.
+
+### Teams
+
+#### `zudelloListOrgTeams`
+**Type**: Read-only
+**Description**: List all teams in organization
+
+#### `zudelloFetchOrgTeam`
+**Type**: Read-only
+**Description**: Get single team details
+**Key Parameters**:
+- `uuid`: Team UUID
+
+#### `zudelloUpdateOrgTeam`
+**Type**: Write (High Risk)
+**Description**: Update team configuration (affects all team users)
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Team UUID
+- `team_config`: Updated configuration
+
+### Users
+
+#### `zudelloListOrgUsers`
+**Type**: Read-only
+**Description**: List all users in organization
+**Key Parameters**:
+- `limit`, `offset`: Pagination
+
+#### `zudelloFetchOrgUser`
+**Type**: Read-only
+**Description**: Get single user details
+**Key Parameters**:
+- `uuid`: User UUID
+
+#### `zudelloCreateOrgUser`
+**Type**: Write (High Risk)
+**Description**: Create new user in organization
+**Requires Approval**: Yes
+**Key Parameters**:
+- `email`: User email
+- `name`: User name
+- `user_config`: User configuration
+
+#### `zudelloUpdateOrgUser`
+**Type**: Write (Medium Risk)
+**Description**: Update user profile information
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: User UUID
+- `user_config`: Updated profile
+
+#### `zudelloAssignUserToTeam`
+**Type**: Write (High Risk)
+**Description**: Assign user to team with permissions
+**Requires Approval**: Yes
+**Key Parameters**:
+- `userUuid`: User UUID
+- `teamUuid`: Team UUID
+- `groups`: Permission groups (optional)
+
+### Groups
+
+#### `zudelloListOrgUserGroups`
+**Type**: Read-only
+**Description**: List organization-level user groups
+
+---
+
+## Notifications
+
+### `zudelloListNotificationTypes`
+**Type**: Read-only
+**Description**: List all available notification types
+
+### `zudelloGetNotificationPreferences`
+**Type**: Read-only
+**Description**: Get user notification preferences
+
+### `zudelloUpdateNotificationPreferences`
+**Type**: Write (Low Risk)
+**Description**: Update user notification preferences
+**Requires Approval**: Yes
+**Key Parameters**:
+- `preferences`: Updated preferences object
+
+---
+
+## Exception Reasons
+
+### Budget Exceptions
+
+#### `zudelloListBudgetExceptionReasons`
+**Type**: Read-only
+**Description**: List budget exception reasons
+
+#### `zudelloCreateBudgetExceptionReason`
+**Type**: Write (Medium Risk)
+**Description**: Create new budget exception reason
+**Requires Approval**: Yes
+**Key Parameters**:
+- `code`: Exception code
+- `name`: Display name
+- `context`: Application context
+
+#### `zudelloUpdateBudgetExceptionReason`
+**Type**: Write (High Risk)
+**Description**: Update budget exception reason
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Exception UUID
+- `code`, `name`: Updated values
+- `context`: Application context
+
+### Contract Exceptions
+
+#### `zudelloListContractExceptionReasons`
+**Type**: Read-only
+**Description**: List contract exception reasons
+
+#### `zudelloCreateContractExceptionReason`
+**Type**: Write (Medium Risk)
+**Description**: Create new contract exception reason
+**Requires Approval**: Yes
+**Key Parameters**:
+- `code`: Exception code
+- `name`: Display name
+- `context`: Application context
+
+#### `zudelloUpdateContractExceptionReason`
+**Type**: Write (High Risk)
+**Description**: Update contract exception reason
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Exception UUID
+- `code`, `name`: Updated values
+- `context`: Application context
+
+---
+
+## Language Placeholders
+
+### `zudelloGetLanguagePlaceholders`
+**Type**: Read-only
+**Description**: Get custom terminology labels for team
+
+### `zudelloUpdateLanguagePlaceholders`
+**Type**: Write (Medium Risk)
+**Description**: Update UI language placeholders (affects all team users)
+**Requires Approval**: Yes
+**Key Parameters**:
+- `placeholders`: Object with placeholder key-value pairs
+
+---
+
+## Inbox Management
+
+### Domain
+
+#### `zudelloGetInboundDomain`
+**Type**: Read-only
+**Description**: Get email domain configuration for document ingestion
+
+### Inboxes
+
+#### `zudelloListInboxes`
+**Type**: Read-only
+**Description**: List all email inboxes
+
+#### `zudelloFetchInbox`
+**Type**: Read-only
+**Description**: Get single inbox details
+**Key Parameters**:
+- `uuid`: Inbox UUID
+
+#### `zudelloCreateInbox`
+**Type**: Write (Medium Risk)
+**Description**: Create new email inbox
+**Requires Approval**: Yes
+**Key Parameters**:
+- `name`: Inbox name
+- `inbox_config`: Inbox configuration
+
+#### `zudelloUpdateInbox`
+**Type**: Write (Medium Risk)
+**Description**: Update inbox settings
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Inbox UUID
+- `inbox_config`: Updated configuration
+
+### Templates
+
+#### `zudelloListInboxTemplates`
+**Type**: Read-only
+**Description**: List email templates for inboxes
+
+#### `zudelloCreateInboxTemplate`
+**Type**: Write (Medium Risk)
+**Description**: Create new inbox template
+**Requires Approval**: Yes
+**Key Parameters**:
+- `name`: Template name
+- `template_config`: Template configuration
+
+#### `zudelloUpdateInboxTemplate`
+**Type**: Write (High Risk)
+**Description**: Update inbox template (affects document routing)
+**Requires Approval**: Yes
+**Key Parameters**:
+- `uuid`: Template UUID
+- `template_config`: Updated configuration
+
+---
+
+## Document Context
+
+### `zudelloCheckDocumentBudgets`
+**Type**: Read-only
+**Description**: Validate document against budget constraints
+**Use Cases**:
+- Pre-approval validation
+- Budget compliance checking
+- Real-time budget warnings
+
+**Key Parameters**:
+- `document_uuid`: Document to validate
+- `budget_uuids`: Budgets to check against (optional)
+
+### `zudelloCheckContractPricing`
+**Type**: Read-only
+**Description**: Check document pricing against contract terms
+**Use Cases**:
+- Contract compliance validation
+- Pricing verification
+- Pre-approval checks
+
+**Key Parameters**:
+- `document_uuid`: Document to validate
+- `contract_uuid`: Contract to check against (optional)
+
+---
+
+## Document Statuses
+
+### `zudelloListStatuses`
+**Type**: Read-only
+**Description**: List document statuses for a module
+**Key Parameters**:
+- `module`: Module filter (optional)
+- `submodule`: Submodule filter (optional)
+- `includePaths`: Field selection (optional)
+
+### `zudelloGetStatus`
+**Type**: Read-only
+**Description**: Get single status details
+**Key Parameters**:
+- `statusUuid`: Status UUID
+
+### `zudelloCreateStatus`
+**Type**: Write (Medium Risk)
+**Description**: Create new document status
+**Requires Approval**: Yes
+**Key Parameters**:
+- `key`: Status key (UPPER_SNAKE_CASE)
+- `name`: Display name
+- `type`: Status type (ACTIVE, APPROVE, REVIEW, etc.)
+- `module`: Target module
+- `submodule`: Target submodule
+- `color`: Hex color (optional)
+- `order`: Display order (optional)
+
+### `zudelloUpdateStatus`
+**Type**: Write (Medium Risk)
+**Description**: Update existing document status
+**Requires Approval**: Yes
+**Key Parameters**:
+- `statusUuid`: Status UUID
+- `key`, `name`, `type`: Updated values
+- `module`, `submodule`: Context
+- `color`, `order`: Display settings
+
+### `zudelloReorderStatuses`
+**Type**: Write (Low Risk)
+**Description**: Reorder document statuses for UI display
+**Requires Approval**: Yes
+**Key Parameters**:
+- `statusOrders`: Array of {uuid, order} objects
+
+---
+
+## Risk Levels Summary
+
+### High Risk (11 tools)
+Require careful review before execution. These operations can significantly impact system behavior or data.
+
+### Medium Risk (24 tools)
+Require approval but have more limited impact scope. Generally safe with proper validation.
+
+### Low Risk (6 tools)
+Minimal impact operations that still require approval for audit purposes.
+
+---
+
+## Common Patterns
+
+### Pagination
+Most list tools support pagination with `limit` and `offset` parameters:
+```json
+{
+  "limit": 50,
+  "offset": 0
+}
+```
+
+### Filtering
+Search and list operations use filter objects:
+```json
+{
+  "filter": {
+    "status": "approved",
+    "created_date__gte": "2024-01-01"
+  }
+}
+```
+
+### Context Objects
+Many tools require context specification:
+```json
+{
+  "context": {
+    "PURCHASING": ["INVOICE"],
+    "EXPENSES": ["CLAIM"]
+  }
+}
+```
+
+### Field Selection
+Optimize responses with `select` or `includePaths`:
+```json
+{
+  "select": ["uuid", "name", "status"],
+  "includePaths": ["payload.key", "payload.name"]
+}
+```
+
+---
+
+## Best Practices
+
+1. **Start with List/Get operations** before using Write operations
+2. **Use field selection** to minimize response payload size
+3. **Implement pagination** for large datasets
+4. **Check approval metadata** before executing write operations
+5. **Use context filters** to scope operations appropriately
+6. **Leverage model discovery tools** to understand data structures
+7. **Review history** for audit trails and troubleshooting
+8. **Test with read-only tools** before implementing write workflows
+
+---
+
+For implementation details and code examples, see the main README.md and source code documentation.