@theyahia/1c-rest-mcp

MCP server for 1C:Enterprise REST API via OData 3.0 — catalogs, documents, registers, accounting, constants, reports, batch ops & change-tracking + metadata discovery. 32 tools across 11 modules. HTTP Basic auth. Stdio + Streamable HTTP transports.

---

Migrating from v1.x

If you starred or used v1.x, the v2.0.0 release introduces a few breaking changes:

• HTTP transport env var renamed: PORT=3000 → HTTP_PORT=3000.
• Removed separate HTTP binary: 1c-rest-mcp-http is gone. Use 1c-rest-mcp --http or HTTP_PORT=3000 1c-rest-mcp instead.
• Single bin entrypoint: dist/http.js is no longer published.
• Internal client: now extends @theyahia/mcp-core's BaseHttpClient with BasicAuthStrategy. The exported functional API (oneCGet/oneCPost/oneCPatch/buildODataPath) is unchanged, so tool code keeps working.
• Tool errors: now returned as MCP-spec CallToolResult with isError: true (via withErrorHandling from @theyahia/mcp-core). Compatible with all MCP clients.

Tool names, arguments, return formats, and the ONEC_* env vars are unchanged.

---

Tools (32)

Tools are grouped into modules. All are registered by default; the ONEC_SERVICES env var filters which optional modules load (discovery meta is always on). See Environment Variables.

Discovery — meta (always enabled)

Tool	Description
list_entities	List all available 1C OData entities (catalogs / documents / registers / reports). Use this first when working with an unfamiliar database.
get_document_by_number	Locate a 1C document by its number (e.g. invoice ТД-00123 dated 2026-03-01). Convenience wrapper over $filter.
get_metadata	Return the raw OData $metadata (EDMX/XML) describing every entity, field and type.
describe_entity	List an entity's fields by inspecting one sample record ($top=1) — cheaper than full $metadata.

Catalogs — catalogs

Tool	Description
get_catalogs	Read 1C catalog data. Supports $filter, $select, $orderby, $top, $skip.
create_catalog_item	Create a new catalog item via OData POST (e.g. add a Контрагент or Номенклатура).
update_catalog_item	Update a catalog item via OData PATCH (by Ref_Key GUID).

Documents — documents

Tool	Description
get_documents	Read 1C documents with full OData filtering.
create_document	Create a new document via OData POST.
update_document	Update an existing document via OData PATCH (by Ref_Key GUID).
post_document	Post (провести) a document via the OData bound action Post(). operational toggles оперативное проведение.
unpost_document	Unpost (отменить проведение) a document via Unpost().
delete_document	Physically delete a document via OData DELETE. Prefer set_deletion_mark for a recoverable soft delete.
get_document_lines	Read a document's tabular section (строки, e.g. Товары) by Ref_Key via $expand. Section name is config-specific — discover via get_metadata/describe_entity.

Registers — registers

Tool	Description
get_register	Read information or accumulation register data.
write_information_register	Write a record into an independent information register (POST on InformationRegister_*).
get_accumulation_balance	Accumulation-register balances (остатки) via the OData virtual method Balance(Period=…,Condition=…).

Accounting — accounting

Tool	Description
get_accounting_register	Read accounting-register records (AccountingRegister_*, e.g.

... View full README on GitHub