local_ydb_apply_schema
Destructive
Validates and applies YDB table DDL (YQL) using the official SDK. Action 'apply' requires explicit confirmation to execute after validation.
Instructions
Validate or apply YDB table DDL through the official YDB JS SDK. It accepts raw YQL DDL for PRAGMA plus CREATE TABLE, ALTER TABLE, and DROP TABLE; action=apply validates first and executes only with confirm=true.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile | No | Named profile from local-ydb.config.json. Defaults to config.defaultProfile. | |
| configPath | No | Explicit local-ydb config file path to load for this tool call. Useful when the MCP server should pick up a different config without restart. | |
| action | No | Schema operation to run. validate only checks the YQL DDL through the YDB SDK; apply validates first and executes only with confirm=true. | |
| databasePath | No | YDB database path for SDK validation/application. Defaults to the configured tenant root; root database paths use the static gRPC port. | |
| script | Yes | YQL DDL script to validate or apply. Supports PRAGMA plus CREATE TABLE, ALTER TABLE, and DROP TABLE statements. | |
| confirm | No | Must be true to execute action=apply after SDK validation succeeds. Omit or false for validation plus plan-only output. | |
| timeoutMs | No | SDK operation timeout in milliseconds. Defaults to 120000. | |
| maxOutputBytes | No | Maximum UTF-8 bytes returned per validation/execution issue stream. Defaults to 65536. |