1C MCP Toolkit Proxy

Execute Query

Execute a query in 1C query language and return the results. This tool executes queries on the 1C:Enterprise database using the 1C query language. Results are returned as JSON or TOON format. Args: ctx: MCP Context (injected automatically) query: The query text in 1C query language (e.g., "ВЫБРАТЬ * ИЗ Справочник.Номенклатура") params: Optional dictionary of query parameters (e.g., {"Param1": "value1"}). Parameter values can be:

Execute Code

Execute arbitrary code in 1C language. The execution context is controlled by the execution_context parameter: - 'server' (default): code runs in НаСервереБезКонтекста — DB access, 1C objects, no form context. - 'client': code runs in НаКлиенте — form attributes (ЭтаФорма), UI functions, no DB queries. The result is returned from the 'Результат' (Result) variable as JSON or TOON format. Important limitations (code is executed as a statement block, not a full module): -

Get Metadata

Get metadata information about 1C database objects. This tool returns information about the structure of the 1C database in JSON format. Usage modes: 1. Summary (root types): No parameters (filter/meta_type/name_mask not provided) Returns: - data: list of root metadata types with counts (Тип, Количество) - configuration: configuration/platform info (when available) as a top-level field 2. Filtered list: Use 'meta_type' and/or 'name_mask' parameters

Get Event Log

Get event log entries from 1C database with filtering options and cursor pagination. This tool retrieves entries from the 1C event log (Журнал регистрации) with optional filtering by date range, importance level, event type, and additional filters for data object, metadata type, user, session, etc. Results are returned as JSON or TOON format. Supports cursor pagination for iterating through large result sets: - Response includes last_date, next_same_second_offset, and h

Get Object By Link

Get 1C object data by navigation link. This tool retrieves complete object data from the 1C:Enterprise database using a navigation link. The link format is e1cib/data/Type.Name?ref=HexGUID for standard objects. For external data sources: - Object tables (single key): e1cib/data/ВнешнийИсточникДанных.Source.Таблица.TableName?ref=Value - Non-object tables (composite key): e1cib/data/ВнешнийИсточникДанных.Source.Таблица.TableName?FieldName=Value Results are returned as JSON

Get Link Of Object

Generate a 1C navigation link from an object description. This tool converts an object description (returned by execute_query) into a clickable navigation link that can be used to open the object directly in 1C. Use this tool to provide users with clickable links to 1C objects after finding them with execute_query. Args: ctx: MCP Context (injected automatically) object_description: Object description from execute_query results with fields:

Find References To Object

Find references to a given object across specified metadata collections. This tool searches for references to the target object in documents, catalogs, and registers. It checks all fields whose type can contain a reference to the target object type, then queries for actual matches. The search is performed in two stages: 1. Candidate discovery: metadata traversal to find fields that can hold the target type 2. Query execution: actual queries to find objects/records refer

Get Access Rights

Get role permissions for a metadata object and optionally effective rights for a user. This tool retrieves information about what rights each role grants for the specified metadata object. If a user name is provided, it also calculates the effective rights for that user (sum of all their roles). IMPORTANT limitations: - effective_rights is "rights by sum of roles", NOT a guarantee of real access - RLS (Row Level Security) is NOT taken into account - Contextual restr

Get Bsl Syntax Help

Get syntax reference for 1C BSL language. Search by keywords to find built-in functions, methods, types and language constructs. Returns candidates (unique breadcrumb paths) and Markdown content when exactly one breadcrumb matches. If the single match is a navigation section (no content, has sub-topics), returns its sub-topics as candidates instead. Candidate paths (e.g. "Массив/Методы/Найти") and Markdown link targets from content (format: [Title](topic:Path)) can be used as ke

Get Screenshot

Take a screenshot of the active 1C application window and return it as base64 PNG. Args: form_name: Optional. Full 1C form name (e.g. "Справочник.Контрагенты.Форма.ФормаЭлемента"). If provided, opens the form before capturing the window, then automatically closes the form. If omitted, captures the current active 1C window immediately. scale_percent: Output image scale (10–200, default 100). Values above 100 produce a larger

Restart 1c Session

Restart the current 1C session — the session that executes 1C tool calls. A restart is typically required after updating the 1C configuration (metadata, extensions, BSL code) so the new session picks up the changes. The new session starts automatically with the same database and connection settings; anonymization state is preserved. The current session shuts down once the new one is ready. IMPORTANT: Do NOT call this tool on your own initiative. Only invoke it when explicitly in

Close 1c Session

Close the current 1C session — the session that executes 1C tool calls — and return a launcher script command to start a new one. Use when exclusive database access is needed (e.g. updating configuration). Run the returned command synchronously: exit 0 means the session is ready. On Windows, run the command in PowerShell (not cmd.exe). On timeout, check whether a 1C process was started before launching another. On non-timeout exit 1, read the output: pre-launch errors are saf

Submit For Deanonymization

Submit the final user-facing response for de-anonymization display. You MUST call this tool if, and only if, your final response to the user contains anonymization tokens in the form [CATEGORY-NNNNN], for example [ORG-00001], [PER-00042], [INN-00001]. Call this tool exactly once, immediately before sending the final response to the user. Pass the complete final response text in the "text" parameter. Do NOT call this tool for intermediate reasonin