mcp-creatio 0.3.6

package/.dockerignore

@@ -0,0 +1,12 @@
+node_modules
+npm-debug.log
+Dockerfile*
+.dockerignore
+.git
+.gitignore
+.vscode
+coverage
+dist
+*.tsbuildinfo
+.eslintcache
+.cache

package/.editorconfig

@@ -0,0 +1,14 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = crlf
+insert_final_newline = true
+indent_style = tab
+indent_size = 4
+tab_width = 4
+
+[*.{ts,tsx,js,jsx,json,md,html,css}]
+indent_style = tab
+indent_size = 4
+tab_width = 4

package/.eslintrc.cjs

@@ -0,0 +1,18 @@
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: ['./tsconfig.json'],
+    tsconfigRootDir: __dirname,
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint', 'prettier'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  rules: {
+    'prettier/prettier': 'error',
+  },
+};

package/.gitattributes

@@ -0,0 +1,8 @@
+# Ensure CRLF in repository for these files
+* text=auto eol=crlf
+*.ts text eol=crlf
+*.tsx text eol=crlf
+*.js text eol=crlf
+*.jsx text eol=crlf
+*.json text eol=crlf
+*.md text eol=crlf

package/.github/workflows/docker-publish.yml

@@ -0,0 +1,50 @@
+name: Docker Build and Publish
+
+on:
+    push:
+        branches: ['main']
+        tags: ['v*.*.*']
+    workflow_dispatch:
+
+jobs:
+    docker:
+        runs-on: ubuntu-latest
+
+        permissions:
+            contents: read
+            packages: write
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Set up QEMU
+              uses: docker/setup-qemu-action@v3
+
+            - name: Set up Docker Buildx
+              uses: docker/setup-buildx-action@v3
+
+            - name: Docker Hub login
+              uses: docker/login-action@v3
+              with:
+                  username: ${{ secrets.DOCKER_USERNAME }}
+                  password: ${{ secrets.DOCKER_PASSWORD }}
+
+            - name: Compute Docker tags from package.json
+              id: vars
+              shell: bash
+              run: |
+                  VERSION=$(jq -r .version package.json)
+                  if [[ -z "$VERSION" || "$VERSION" == "null" ]]; then
+                    echo "Package version is empty" >&2
+                    exit 1
+                  fi
+                  echo "tags=crackish/mcp-creatio:latest,crackish/mcp-creatio:v${VERSION}" >> $GITHUB_OUTPUT
+
+            - name: Build and push
+              uses: docker/build-push-action@v6
+              with:
+                  context: .
+                  push: true
+                  platforms: linux/amd64,linux/arm64
+                  tags: ${{ steps.vars.outputs.tags }}

package/.prettierignore

@@ -0,0 +1,3 @@
+node_modules
+dist
+coverage

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "printWidth": 100,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "semi": true,
+  "useTabs": true,
+  "tabWidth": 4,
+  "endOfLine": "crlf"
+}

package/.vscode/launch.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Debug MCP Creatio",
+      "type": "node",
+      "request": "launch",
+      "cwd": "${workspaceFolder}",
+      "runtimeExecutable": "npm",
+      "runtimeArgs": [
+        "run",
+        "start"
+      ],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "env": {
+        "CREATIO_BASE_URL": "https://your-creatio.com",
+        "CREATIO_LOGIN": "Supervisor",
+        "CREATIO_PASSWORD": "Supervisor"
+      }
+    }
+  ]
+}

package/.vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+	"servers": {
+		"creatio_local": {
+			"url": "http://localhost:3000/mcp",
+			"type": "http"
+		},
+		"creatio_demo": {
+			"url": "http://a_vanikhin:7700/mcp",
+			"type": "http"
+		}
+	},
+	"inputs": []
+}

package/.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+  "editor.formatOnSave": true,
+  "editor.insertSpaces": false,
+  "editor.tabSize": 4,
+  "files.eol": "\r\n",
+  "files.encoding": "utf8",
+  "editor.detectIndentation": false,
+  "[typescript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "eslint.validate": ["typescript", "typescriptreact"],
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit",
+    "source.fixAll.eslint": "explicit"
+  }
+}

package/Agent.md

@@ -0,0 +1,187 @@
+# Agent Guide: MCP Creatio Server
+
+This document is for AI coding agents contributing to this repository. It explains project purpose, architecture, invariants, and safe extension patterns.
+
+## 1. Purpose
+
+An implementation of a Model Context Protocol (MCP) server that exposes Creatio CRM to MCP-compatible AI clients (Claude Desktop, ChatGPT Connectors, GitHub Copilot, etc.).
+
+Primary goals:
+
+- Provide stable tool surface for CRUD, schema discovery, business process execution.
+- Enforce safe data operations (especially Activities ownership rules, date/time UTC handling).
+- Offer prompts that guide LLMs to use Creatio correctly.
+
+## 2. High-Level Architecture
+
+```
+src/
+  creatio/            ← Low-level Creatio API client & auth providers
+  server/             ← MCP server + HTTP layer (OAuth server, handlers)
+    mcp/              ← MCP tool descriptors, prompts, filters builder
+    oauth/            ← Local OAuth 2.1 authorization server for clients
+  services/           ← Session/token refresh orchestration
+  utils/              ← Reusable helpers (env, network, pkce, context)
+  types/              ← Shared TypeScript interfaces & DTO shapes
+```
+
+Key flows:
+
+1. Client authenticates (legacy credentials OR OAuth2 variants).
+2. MCP server registers tools using descriptors from `server/mcp/tools-data.ts`.
+3. Tool handlers call into `CreatioEngineManager`, which resolves a `CreatioServiceContext` (built from `src/creatio/services/*`) and delegates work to the appropriate provider (CRUD, process, sys-settings, user).
+4. Responses are normalized into MCP content blocks.
+
+### Creatio Service Stack (LLM Cheat Sheet)
+
+```
+CreatioServiceContext
+  ├─ CreatioAuthManager → selects concrete auth provider (legacy / OAuth2 / OAuth2 code)
+  ├─ CreatioHttpClient → transport + logging + retry + header helpers
+  ├─ ODataMetadataStore → caches entity schemas per environment
+  ├─ ODataCrudProvider → implements CrudProvider using http + metadata
+  ├─ ProcessServiceProvider → POSTs to ProcessEngineService
+  ├─ SysSettingsServiceProvider → DataService JSON endpoint
+  └─ UserInfoProvider → UserInfoService for current user data
+```
+
+Usage pattern:
+
+- Handlers never craft raw fetch calls. They work through provider interfaces exposed by the context (`provider.crud`, `provider.process`, etc.).
+- If you need a new Creatio capability, add a dedicated provider (or extend an existing one) and wire it up inside `CreatioServiceContext`.
+- `CreatioHttpClient` should stay transport-focused (auth headers, retries, timing). Keep endpoint-specific logic inside providers or a dedicated endpoint helper.
+
+## 3. Core Modules You Will Touch
+
+| Area                         | File(s)                          | Notes                                                                                                        |
+| ---------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| Tool registration            | `src/server/mcp/server.ts`       | Add/remove tool handlers; keep descriptors in separate file.                                                 |
+| Tool schemas & text guidance | `src/server/mcp/tools-data.ts`   | Use `zod` schemas; detailed descriptions help AI reasoning.                                                  |
+| Filters logic                | `src/server/mcp/filters.ts`      | Converts structured JSON filters into OData `$filter` strings.                                               |
+| Prompts                      | `src/server/mcp/prompts-data.ts` | Pre-baked instructional prompts consumed by clients.                                                         |
+| Creatio API                  | `src/creatio/services/*`         | `CreatioServiceContext` composes auth + http client + providers; extend providers instead of bypassing them. |
+| OAuth for clients            | `src/server/oauth/*`             | Maintains tokens for MCP clients; ephemeral memory by default.                                               |
+
+## 4. Invariants & Rules (Do NOT Break)
+
+1. All date/time fields passed to Creatio MUST be UTC ISO8601 with `Z` suffix.
+2. Activity creation: Always set `OwnerId` and `AuthorId` to current user's ContactId obtained via `get-current-user-info` unless user explicitly specifies another owner.
+3. Avoid adding blocking network calls in tool descriptors—descriptors must be static; logic belongs in handlers.
+4. Never silently swallow errors coming from Creatio—log via `log.error` then rethrow.
+5. Keep tool names stable: lowercase kebab-case (e.g. `execute-process`).
+6. Keep authentication precedence: Authorization Code > Client Credentials > Legacy.
+7. Do not leak secrets or access tokens in tool responses.
+8. `READONLY_MODE=true` must guarantee no mutation tools (`create`, `update`, `delete`, `execute-process`) are registered.
+
+## 5. Adding a New Tool (Checklist)
+
+1. Define input shape in `tools-data.ts` using `zod`.
+2. Provide rich description (include examples, edge cases, warnings).
+3. Export descriptor & input schema.
+4. Register in `server.ts` via `_registerHandlerWithDescriptor` (respect readonly mode if mutating).
+5. Implement the handler by calling the appropriate provider on the `CreatioServiceContext` (via `CreatioEngineManager`); if functionality is missing, extend or add a provider under `src/creatio/services` rather than issuing raw fetch calls.
+6. Ensure responses are formatted as `{ content: [{ type: 'text', text: JSON.stringify(result) }] }` when not already MCP native.
+7. Add edge-case validation (empty arrays, invalid GUID, missing required filter fields).
+8. Update documentation (README if public feature; otherwise just Agent.md).
+
+## 6. Error Handling Pattern
+
+- Use `try/catch` in handlers ONLY if you need to wrap/transform the error.
+- Log with contextual tag: `log.error('mcp.tool.handler', err)`.
+- Throw the original error afterward (MCP layer will relay).
+- For validation failures rely on `withValidation(...)` wrapper.
+
+## 7. Logging Guidelines
+
+- Use `log.info('mcp.tool.register', { tool })` when registering tools.
+- Use `log.warn` for non-fatal recoverable issues (e.g., partial data fetch).
+- Use `log.error` strictly for failures that abort the operation.
+
+## 8. Performance Considerations
+
+- Prefer `select` + `expand` to limit payload size; educate users via descriptor text.
+- Batch calls carefully—avoid sequential redundant reads if data already provided.
+- Avoid adding expensive synchronous CPU logic inside handlers.
+
+## 9. Security & Safety
+
+- Never echo passwords or client secrets back to clients.
+- Strip or mask token-like values if accidentally included in objects.
+- Validate GUID format (8-4-4-4-12 hex) when exposing user input into queries.
+
+## 10. Testing (Minimal Approach)
+
+Currently no formal test suite. For quick validation:
+
+- Start server locally (`npm start`) and manually invoke tools from an MCP client.
+- Consider adding lightweight Jest tests for filter builder and client methods (future enhancement).
+
+## 11. Versioning & Release
+
+- Increment `package.json` version; code reads dynamically via `src/version.ts`.
+- Use semantic prefixes in commits: `feat:`, `fix:`, `docs:`, `chore:`.
+- Tag releases: `git tag vX.Y.Z && git push --tags` (manual unless automated later).
+
+## 12. Common Edge Cases
+
+| Case                                      | Mitigation                                                     |
+| ----------------------------------------- | -------------------------------------------------------------- |
+| Empty `select` array supplied             | Preprocess to `undefined` (already handled)                    |
+| Mixed raw `filter` + structured `filters` | Combine with `and` parenthesized in handler                    |
+| Invalid GUID quoting                      | Provide guidance text + possible pre-validation before sending |
+| Large result sets                         | Encourage `top` param (<200 recommended)                       |
+| Readonly mode attempt to mutate           | Ensure mutation tools not registered                           |
+
+## 13. Extending Authentication
+
+If adding new auth provider:
+
+1. Create provider under `src/creatio/auth/providers/` implementing shared interface.
+2. Add selection logic in `auth-manager.ts` maintaining precedence ordering.
+3. Document environment variables clearly in README + Agent.md.
+
+## 14. Prompts Extension
+
+- Add new prompt object in `prompts-data.ts` (`name`, `title`, `description`, `argsSchema`, `callback`).
+- Keep names unique and descriptive.
+- Avoid external network calls inside prompt callbacks.
+
+## 15. Code Style
+
+Baseline rules live in `docs/coding-style.md`. Highlights:
+
+- Keep TypeScript strict (avoid `any`, prefer explicit interfaces).
+- Follow the class-member ordering guide (readonly fields → fields → getters → setters → constructor → methods, each ordered `private → protected → public`).
+- Prefix private fields/methods with `_`.
+- Use existing utility wrappers (e.g., `withValidation`).
+- Keep functions small; single responsibility.
+- Reuse logging tags already established.
+
+## 16. What NOT To Do
+
+- Do not reintroduce removed tools (`search`, `fetch`) unless strong justification & design review.
+- Do not bypass `CreatioServiceContext`/providers with raw fetch calls scattered in handlers.
+- Do not embed long multi-megabyte payloads in commit history (limit sample data).
+
+## 17. Quick Start for Agent Changes
+
+1. Make code edits.
+2. Run `npm run build` to ensure TypeScript passes.
+3. Optionally lint: `npm run lint`.
+4. Commit using conventional message.
+5. Push; consider tag if version bump.
+
+## 18. Future Enhancements (Suggestions)
+
+- Add Jest test suite for filter builder + auth flows.
+- Implement persistent token storage (e.g., file/Redis) for OAuth tokens.
+- Add rate limiting to prevent excessive query load.
+- Provide structured error codes instead of raw messages.
+
+## 19. Contact Points
+
+If you need business logic clarification, check existing descriptor guidance first. Many patterns (date handling, ownership) are documented inline in `tools-data.ts`.
+
+---
+
+**Summary:** Focus on safe MCP tool extension around Creatio CRM. Preserve invariants, keep descriptors rich, centralize API interactions, and avoid leaking credentials.

package/Debug.md

@@ -0,0 +1,32 @@
+# Debug Guide
+
+## PowerShell ISE Quick Start
+
+1. Open **Windows PowerShell ISE (x64)** with the working directory set to the project root.
+2. Copy the snippet below into a new script tab (for example, save it as `debug-creatio.ps1`).
+3. Update the placeholder values to match your Creatio instance.
+4. Press `F5` (or click **Run Script**) to launch the server with the desired environment.
+
+```powershell
+# debug-creatio.ps1
+# Sets temporary environment variables for the current ISE session
+# and starts the MCP Creatio server in development mode.
+
+$env:CREATIO_BASE_URL = "https://your-creatio.com"
+$env:CREATIO_LOGIN = "your_login"
+$env:CREATIO_PASSWORD = "your_password"
+
+# Optional: adjust logging verbosity or other flags here
+# $env:LOG_LEVEL = "debug"
+
+# Start the server with the configured environment
+npm start
+```
+
+### Notes
+
+- Environment variables assigned with `$env:` live only for the current ISE session; close the session to clear them.
+- If you prefer reusable configuration, convert the snippet into a standalone `.ps1` file and commit the real credentials to a secure secrets manager instead of the repository.
+- When debugging authentication, consider leveraging the existing logging utilities in `src/log.ts` to inspect token exchange flows.
+- For deeper tracing (e.g., OAuth callback handling), set breakpoints in `src/server/http/creatio-oauth-handlers.ts` and `src/server/mcp/server.ts` before running the script.
+- The `Debug MCP Creatio` configuration in `.vscode/launch.json` mirrors these environment variables; adjust the placeholder values there to attach VS Code's debugger directly to `npm start`.

package/Dockerfile

@@ -0,0 +1,23 @@
+# Minimal Dockerfile for MCP Creatio Server
+# Builds and runs with ts-node (no separate build step)
+
+FROM node:20-alpine AS base
+
+# App directory
+WORKDIR /app
+
+# Install production and dev deps (ts-node, types)
+COPY package.json package-lock.json* ./
+RUN npm ci || npm install
+
+# Copy source
+COPY . .
+
+# Environment (override at runtime)
+ENV PORT=3000
+
+# Expose MCP HTTP port
+EXPOSE 3000
+
+# Start the server (ts-node)
+CMD ["npm", "run", "start"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Andrii Vanikhin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# MCP Creatio Server
+
+Model Context Protocol (MCP) server for Creatio (https://www.creatio.com/) - connect Claude Desktop, ChatGPT, and other AI tools to your Creatio data.
+
+## Overview
+
+- Exposes Creatio data as MCP tools for MCP-compatible clients (Claude Desktop, ChatGPT Connectors, GitHub Copilot)
+- Supports reading, creating, updating, deleting records and inspecting schema
+- Execute Creatio business processes with parameters
+- Uses Creatio OData v4 API under the hood
+
+## Features
+
+- **CRUD operations**: `read`, `create`, `update`, `delete` Creatio records
+- **Schema discovery**: `list-entities`, `describe-entity`
+- **Business processes**: `execute-process` to run Creatio workflows
+- **System settings**: `create-sys-setting`, `update-sys-setting-definition`, `query-sys-settings`, and `set-sys-settings-value` to create, adjust metadata, inspect, or assign values
+- **AI assistant compatibility**: Claude Desktop, ChatGPT Connectors, GitHub Copilot
+- **Three authentication modes**: Legacy login/password, OAuth2 client credentials, OAuth2 authorization code
+- **Built-in OAuth server**: Automatic MCP client authentication
+- **Docker ready**: Multi-arch images available
+
+## Quick Start
+
+1. Set environment variables (see below)
+2. Run: `npm start` or use Docker
+
+## Command (stdio) mode
+
+You can run the server as a command (no separate HTTP `/mcp` endpoint) so MCP clients can connect over stdio directly.
+
+### Direct command
+
+```bash
+npx -y mcp-creatio \
+  --base-url https://your-creatio.com \
+  --login YourLogin \
+  --password YourPassword
+```
+
+Default transport for CLI is `stdio`.
+
+### MCP client config example (command-based)
+
+```json
+{
+  "creatio": {
+    "command": "npx",
+    "args": [
+      "-y",
+      "mcp-creatio",
+      "--base-url",
+      "https://your-creatio.com",
+      "--login",
+      "YourLogin",
+      "--password",
+      "YourPassword"
+    ]
+  }
+}
+```
+
+### Local repo (analogue without publishing)
+
+```bash
+npm run start:stdio -- --base-url https://your-creatio.com --login YourLogin --password YourPassword
+```
+
+## Configuration
+
+| Variable                     | Description                                                          |
+| ---------------------------- | -------------------------------------------------------------------- |
+| `CREATIO_BASE_URL`           | **Required**. Creatio instance URL (e.g. `https://your-creatio.com`) |
+| `CREATIO_LOGIN`              | Username for legacy auth                                             |
+| `CREATIO_PASSWORD`           | Password for legacy auth                                             |
+| `CREATIO_CLIENT_ID`          | OAuth2 client credentials ID                                         |
+| `CREATIO_CLIENT_SECRET`      | OAuth2 client credentials secret                                     |
+| `CREATIO_ID_BASE_URL`        | Identity Service URL (if separate from main Creatio instance)        |
+| `CREATIO_CODE_CLIENT_ID`     | OAuth2 authorization code client ID                                  |
+| `CREATIO_CODE_CLIENT_SECRET` | OAuth2 authorization code client secret                              |
+| `CREATIO_CODE_REDIRECT_URI`  | OAuth2 redirect URI (e.g. `http://localhost:3000/oauth/callback`)    |
+| `CREATIO_CODE_SCOPE`         | OAuth2 scope (e.g. `offline_access ApplicationAccess_yourappguid`)   |
+| `READONLY_MODE`              | Set `true` to disable create/update/delete operations                |
+
+## Authentication Modes
+
+Choose one of three ways to authenticate with Creatio:
+
+### 1. Legacy (Username/Password)
+
+```bash
+CREATIO_LOGIN=YourLogin
+CREATIO_PASSWORD=YourPassword
+```
+
+### 2. OAuth2 Client Credentials
+
+For server-to-server authentication. [Setup guide →](https://academy.creatio.com/docs/8.x/dev/development-on-creatio-platform/integrations-and-api/authentication/oauth-2-0-authorization/identity-service-overview)
+
+```bash
+CREATIO_CLIENT_ID=your_client_id
+CREATIO_CLIENT_SECRET=your_client_secret
+```
+
+### 3. OAuth2 Authorization Code
+
+For user-delegated access with web authorization. [Setup guide →](https://academy.creatio.com/docs/8.x/dev/development-on-creatio-platform/integrations-and-api/authentication/oauth-2-0-authorization/authorization-code-grant)
+
+```bash
+CREATIO_CODE_CLIENT_ID=your_client_id
+CREATIO_CODE_CLIENT_SECRET=your_client_secret
+CREATIO_CODE_REDIRECT_URI=http://localhost:3000/oauth/callback
+CREATIO_CODE_SCOPE="offline_access ApplicationAccess_yourappguid"
+```
+
+**Note**: Currently uses in-memory storage for OAuth tokens. Tokens will be lost on server restart.
+
+**Priority**: Authorization Code > Client Credentials > Legacy
+
+## MCP Client Authentication
+
+The server includes OAuth 2.1 Authorization Server for MCP clients (Claude Desktop, etc.). No additional setup required - clients authenticate automatically through standard OAuth flow.
+
+## Examples
+
+### Node.js (Legacy Auth)
+
+```bash
+export CREATIO_BASE_URL="https://your-creatio.com"
+export CREATIO_LOGIN="YourLogin"
+export CREATIO_PASSWORD="YourPassword"
+npm start
+```
+
+### Docker (Legacy Auth)
+
+```bash
+docker run --rm -p 3000:3000 \
+  -e CREATIO_BASE_URL="https://your-creatio.com" \
+  -e CREATIO_LOGIN="YourLogin" \
+  -e CREATIO_PASSWORD="YourPassword" \
+  crackish/mcp-creatio
+```
+
+## Available Tools
+
+| Tool                            | Description                                                                                                                                                                                                                 |
+| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `get-current-user-info`         | Fetches the Creatio contact details for the authenticated MCP user                                                                                                                                                          |
+| `list-entities`                 | List all available entity sets                                                                                                                                                                                              |
+| `describe-entity`               | Get schema for entity (fields, types, keys)                                                                                                                                                                                 |
+| `read`                          | Query records with optional filters                                                                                                                                                                                         |
+| `create`                        | Create new record                                                                                                                                                                                                           |
+| `update`                        | Update existing record                                                                                                                                                                                                      |
+| `delete`                        | Delete record                                                                                                                                                                                                               |
+| `execute-process`               | Run Creatio business processes                                                                                                                                                                                              |
+| `query-sys-settings`            | Retrieve the current values and metadata for one or more sys settings                                                                                                                                                       |
+| `set-sys-settings-value`        | Update one or more sys settings via PostSysSettingsValues                                                                                                                                                                   |
+| `create-sys-setting`            | Create a new sys setting record and optional initial value assignment                                                                                                                                                       |
+| `update-sys-setting-definition` | Modify sys setting metadata (name, value type, cache flags, lookup reference) via UpdateSysSettingRequest. Creatio requires Code, Name, and valueTypeName to be included on every update, even if the values are unchanged. |
+
+> **Note**: Previously documented `search`/`fetch` helper tools (for a specific connector workflow) have been removed as they are no longer required.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}