# local-ydb-mcp vs ydb-platform/ydb-mcp

local-ydb-toolkit ships @astandrik/local-ydb-mcp for operating Docker-based local-ydb environments. Use the official ydb-platform/ydb-mcp server for database-level work against an existing YDB endpoint.

## Use @astandrik/local-ydb-mcp for

- Docker inventory, local-ydb readiness, YDB healthcheck, tenant state, node registration, GraphShard checks, auth posture, storage placement, and logs.
- Root /local bootstrap or CMS tenant bootstrap with dynamic nodes.
- YDB table DDL generation, validation, plan-only application, and confirmed application.
- Auth hardening, dump listing, path-level dump/restore, storage group workflows, cleanup, and version upgrades.

## Use ydb-platform/ydb-mcp for

- Ad hoc SQL and query explanation against an already running YDB endpoint.
- Database-level directory listing, path inspection, and query-oriented exploration.
- General YDB interaction that does not need Docker local-ydb lifecycle control.

## Safety model

@astandrik/local-ydb-mcp is plan-first: mutating tools return planned commands, risk, rollback, and verification unless the caller supplies `confirm: true`. That matters when an agent can touch containers, volumes, auth files, storage pools, and dumps.