Register/update a 1C source tree; format is detected automatically when format=auto.

Discover/register 1C configuration and extension source directories under a root directory.

List RAG source discovery roots and optionally sync newly added configurations/extensions.

List RAG-available configurations, extensions, snapshots and discovery roots.

Auto-configure the session RAG snapshot from the live 1C configuration and installed extensions.

The tool reads the live main configuration/version from ВерсииПодсистем, reads installed extensions from ВерсииРасширений, matches them against registered RAG sources by metadata name and version, and creates/binds a snapshot.

When no exact/suitable source exists and dump_if_missing=true, Answer42 can create RAG sources by dumping the configuration and extensions to Designer XML. Dumping requires a direct Designer connection: server infobase (server/ib) or file infobase path. Web /WS URLs cannot be dumped; for web sessions pass dump_connection_value, file_infobase_path, or cf_files/cfe_files. If the direct dump connection has different users than the web publication (for example multitenant/separated-data infobases), pass dump_username and dump_password; otherwise the current session credentials are reused. Temporary infobases created from CF/CFE files are deleted after dumping by default. Generated XML source directories are removed after a successful index build by default, because the SQLite RAG index is self-contained; pass cleanup_generated_sources=false when the dumped XML source tree should be kept under dump_root for inspection or reuse.

List registered 1C source trees.

Create/update an effective configuration snapshot from base + extensions.

List effective RAG snapshots and their layers.

Build/rebuild the SQLite/FTS RAG index for a source or snapshot.

Look up an indexed 1C metadata object, including navigation, fields and forms.

RAG describes configuration source metadata, not live infobase data, access rights, user settings, or a report result. Inspect rag_diagnostic before concluding that an object is absent, then use live UI tools when current runtime state matters.

Search business terms and full-text RAG chunks in the local SQLite index.

Use RAG to discover metadata names, fields, forms, and base/extension layers; it is not evidence of current live data, permissions, or report output. Inspect rag_diagnostic if search returns no useful result.

List active/restorable Answer42 sessions and their connection state.

Return bridge, runtime, test-client and RAG state for a session.

One-shot session factory: detect version, start infrastructure, and connect the 1C test client.

base_url may be a web publication URL, server/infobase, or a file infobase path. Prefer credentials saved with credentials_save over passing secrets in tool calls. After a long UI operation, use client_busy_status or wait_client_idle before sending more commands.

Tear down a session: disconnect test-client, stop test-manager, ibsrv, Xvfb and bridge.

Export the 1C event log.

Check whether credentials exist for a base URL or saved title without returning secrets.

Save or update credentials for a URL pattern in the local credentials store.

The credentials file is never committed to git. Use this tool to persist login/password pairs so that start_session can pick them up automatically without exposing secrets in MCP tool-call arguments. Entries are scoped to the current MCP account.

Remove a credential entry from the local store by exact URL match.

List configured credential URL patterns/titles (no usernames or passwords).

List saved credential titles/aliases that can be used as start_session base_url.

Return active 1C test client window state.

Return all windows of the tested 1C client application.

Activate/switch to a tested 1C client window by index, title or name.

Navigate the main test-client window to the start page.

Navigate the main test-client window to the previous open window.

Navigate the main test-client window to the next open window.

Wait until an object appears in the tested client UI tree.

Wait until a form appears.

Wait until a client window appears.

Return current user messages shown in the active test-client window.

Close the user messages panel in the active test-client window.

Return current 1C script error information displayed in the tested client, if any.

Check whether the 1C test client/bridge is responsive and whether a dangerous action is blocking the interface.

Wait until the 1C test client/bridge becomes responsive after a long or blocking UI action.

Preload the result for the next 1C file selection dialog.

Clear queued file selection dialog results.

Return diagnostics for a form field: visibility, availability, readonly, kind, title.

Return field data presentation text via ПолучитьПредставлениеДанных().

Return field tooltip text.

Open a form field dropdown and return visible choice items when exposed by the 1C test-client API.

This is a convenience action for the common "open dropdown and read choices" scenario. For non-mutating diagnostics of an already-open dropdown use field_dropdown_state.

Move focus to the next form element and return the current element.

Move focus to the previous form element and return the current element.

Return active form availability/modified/readonly state.

Return the active form default button, when available.

Wait until the active form closes.

Return command panel for a found UI object, when supported.

Return context menu for a found UI object, when supported.

Return active window command interface, when supported.

Return top-level sections of the active window command interface.

Return command-interface command tree and flattened command list, optionally filtered by section.

Search live command-interface commands by title, path or navigation URL.

Expand a collapsible form group.

Collapse a collapsible form group.

Return current page of a page-group form element.

Activate/switch to another page in a page-group form element.

Return form group expanded/visible/available state.

Return hyperlink presentations from a formatted-string decoration.

Click a hyperlink inside a formatted-string decoration.

Click a form decoration.

Return a serialized snapshot of the active 1C UI tree.

Default profile is navigation: visible elements, compact fields, no data presentations, no RAG enrichment, and command panels excluded unless requested. include_rag_types defaults to auto: RAG enrichment is enabled for diagnostic, data and full profiles and disabled for navigation profiles. The tree has no depth limit. Use include_hidden=true for hidden pages/elements. Pass parent_name to serialize only the subtree rooted at a specific form element. Use fields=minimal|navigation|diagnostic|data|full (or a comma-separated field list) to control returned node fields without changing traversal.

include_data=true may call 1C ПолучитьПредставлениеДанных() for many nodes; do not enable it casually on large forms. Prefer targeted tools for data: field_value_text for one field, table_rows for tables/dynamic lists, and tabular_document_text/tabular_document_save for reports/tabular documents.

When name, title or type filter is set, the result is a flat objects list instead of a nested tree. For finding one control, prefer search_objects/find_object. format=outline and format=yaml|yml return readable text representations inside a structured tool result; JSON remains the default machine-readable form.

delivery=auto is the default: small results stay inline, but large results above ONEC_MCP_UI_TREE_RESOURCE_AUTO_THRESHOLD_TOKENS (default 50k estimated tokens) are saved as MCP resources. Use delivery=inline to force inline output and delivery=resource to force resource output for large/verbose diagnostics (profile=full, include_hidden=true, include_data=true). Resource responses contain only resource_uri, snapshot_id, summary, metrics and a small preview. Then inspect the saved snapshot with ui_tree_resource_search, ui_tree_resource_get_node, ui_tree_resource_children, or ui_tree_diff instead of loading the whole tree into the agent context.

Search a saved ui_tree resource without loading the full tree into context.

Use after ui_tree(delivery='resource') when you need a few controls from a large snapshot. The result includes path and index_path; use either with ui_tree_resource_get_node, ui_tree_resource_children, or ui_tree_resource_action.

Return one node from a saved ui_tree resource by index_path or path.

Return a small subtree from a saved ui_tree resource.

Prefer this over MCP resource reads when the full snapshot is large. Set depth=1 to inspect direct children, depth=2 for immediate context.

Compare two saved ui_tree snapshots and return compact added/removed/changed node samples.

Run a safe first-class UI action using a node selected from a saved ui_tree snapshot.

The snapshot is only used to extract stable name/title/type hints; the actual action is executed against the current live 1C UI via existing tools. Refresh the snapshot after large UI changes before relying on old selectors.

Low-level diagnostic: return active window/form command-bar data when available.

Prefer command_interface_sections/commands/search for application navigation commands, and object_command_panel/object_context_menu for commands of a specific UI object.

Find a button in the active UI tree and press it.

Find an object in the active UI hierarchy by name, title, or test object type.

Find all UI objects matching name, title and/or 1C test object type.

Low-level escape hatch: call TestedApplication.GetObject with optional wildcard name/title.

Prefer find_object/search_objects for structured diagnostics and focus_object for changing focus. Keep this tool for platform/test-client edge cases where direct GetObject semantics matter.

Move focus to a UI object in the active test client window.

This tool only changes focus/activation; it does not change values. For radio buttons and dropdowns use set_field_value with the visible caption. To switch to an inactive page, focus the page object first, then interact with its children.

Convert 1C object reference GUIDs to e1cib/data navigation links and back.

The pure 1C algorithm is the same as used by platform navigation refs: ref = UUID groups 4 + 5 + 3 + 2 + 1, all lowercase and without hyphens. For example, c3314ae6-6899-11e8-8780-b06ebf2faaf6 becomes 8780b06ebf2faaf611e86899c3314ae6 and can be embedded as e1cib/data/Справочник.ВидыНоменклатуры?ref=8780....

Open an explicit 1C navigation link in the active test-client window.

This tool intentionally rejects arbitrary form command names such as ФормаНайти or СледующаяСтрока. Use first-class MCP tools for form actions, table navigation, search/settings, and dynamic-list operations.

Return the current active form element.

Return whether a field dropdown is open and its visible choice items.

Close an open dropdown for a form field, if it is open.

Return current row of a tested table as key/value text mapping.

Return selected rows of a tested table as key/value text mappings.

Return cell text from a tested table via GetCellText().

List tabular document fields with dimensions; optionally include a cells range.

include_text is intended for small/partial ranges. For large tabular documents, save/export the report to a file and analyze that file instead.

Return dimensions and a cells range of a tabular document field in the active window.

Use this for small tables or partial reads (headers, totals, spot checks). For large reports/tabular documents, prefer tabular_document_save/report export and analyze the saved PDF/XLSX/TXT/HTML file instead of reading UI cells one by one.

Save a tabular document field to a file in the selected format.

Prefer this export to reading a large report cell by cell. Confirm the returned saved state and output path before reporting success. Saving can block a thin client; when interface_blocked=true, wait with client_busy_status or wait_client_idle before sending further UI calls.

Return the state display of a tabular document field, when exposed by 1C.

Set a checkbox-like field using the 1C test client API.

Set a value in a form field by name or title.

Activate/focus a form field by name or title.

Open the standard selection form for a reference field.

Open reference selection form and press its standard Choose button.

Choose the current row in the active selection/list form.

Return rows of a tested table as key/value mappings.

Return/search metadata objects from Справочник.ИдентификаторыОбъектовМетаданных.

The first call opens the standard Universal report for the metadata-identifiers catalog, reads a normalized snapshot with metadata names/synonyms, excludes deleted rows plus roles/subsystems, and stores the result in an in-memory per-session cache. Later calls search that cache unless refresh_cache=true. This is a live UI fallback when RAG is unavailable or stale; if its watchdog reports a blocked interface, wait for client recovery before further UI calls.

Clear cached metadata objects for the current session.

Open the 'Subsystem versions' information register and return the main configuration name/version.

The tool reads РегистрСведений.ВерсииПодсистем via the list output command so that columns available to the dynamic list, including Это основная конфигурация, are visible even when they are not displayed in the default form table.

Open Справочник.ВерсииРасширений and return installed extensions from the latest non-deleted metadata snapshot.

The tool reads catalog rows, ignores rows marked for deletion, takes the latest row by last-use date/code and parses Описание метаданных. Metadata lines starting with EF_ and the main configuration line starting with # are not returned as extensions.

Find a tested table row containing text.

Move cursor to the Nth tested table row containing text.

Move current row using official test-client table navigation methods.

Add a row to the active tested table via the 1C test-client API (Insert / plus).

Set a field in the currently edited row of a form table.

Finds the editor field for the column (e.g. ТоварыНоменклатура), activates it, delegates to the general set_field_value logic, ends row editing, and verifies the value in the current table row.

Set multiple fields in the current row of a form table and verify each value.

Set multiple ordinary form fields using the same logic as set_field_value.

Open the selection form for a reference field in a form table row.

Return diagnostics for currently edited table row and its child fields.

Select all rows in a form table.

Clear all row selection in a form table.

Delete the current row in a form table.

Copy the current row in a form table.

Toggle the delete mark on the current row.

Begin editing the current row in a form table.

End editing the current row in a form table.

Return whether a form table is currently in edit mode.

Return RAG/metadata-known fields for a metadata object; this does not inspect the live UI settings form.

Open the dynamic-list settings form, switch to the requested section tab, and read the 'Доступные поля' table.

Returns the live list of fields available for filtering/ordering/conditional-formatting/grouping in the current dynamic list. This is the authoritative source — it reflects the actual form, not RAG metadata.

Open the dynamic-list settings form and add filter/order elements through the standard dialog.

Filters: [{field, value, comparison?}] — comparison defaults to 'Равно'. Orders: [{field, direction?}] — direction defaults to empty (uses dialog default).

This is the preferred way to apply settings; it uses the same dialog the user sees. Keep clear_first=false unless replacing all user settings was explicitly requested.

Open the dynamic-list settings form and read currently configured filter/order/etc. items.

This reads the selected section's configured elements table, not the 'Доступные поля' table. Use dynamic_list_settings_available_fields when you need fields that can be added. Read current settings before changing them; do not clear or replace existing filters/orders unless the requested scenario explicitly requires it.

Quickly sort the active dynamic list by a visible column title via the 1C test-client API УстановитьПорядок; this is not the settings-form Sort tab.

Press dynamic list 'Вывести список' button and return detected tabular document(s), optionally including text.

Open dynamic-list settings (filter/order/conditional formatting/grouping) via 'Настроить список'.

Search a dynamic list through context menu 'Расширенный поиск' and the standard modal 'Найти' dialog.

Quickly reset/clear dynamic-list filter/order/conditional formatting/grouping settings.

Open the current form customization dialog via 'Изменить форму'.

Save/write the active form.

Close the active form.

Start automatic evidence recording: each recorded tool call gets screenshot + annotated slide.

Manually capture a screenshot/slide in the active recording session.

Stop recording and build PDF evidence from captured slides.

Capture a screenshot from the MCP host. Defaults to the active visible 1C window.

The response always contains the saved path, never image base64. In StreamableHTTP mode it additionally contains an opaque download URL that expires after one hour by default (ONEC_MCP_SCREENSHOT_URL_TTL_SECONDS). Screenshots are for user evidence and UI diagnostics only. Do not use them to analyze report/table/tabular-document/list data; use structured tools such as tabular_document_text, tabular_documents, table_rows, dynamic_list_output, or report export/save tools instead.