# local-ydb-toolkit Agent Access

Connect agents to local-ydb-toolkit through machine-readable docs, public JSON, and the read-only promo MCP.

## Quickstart

```bash
npx @astandrik/local-ydb-mcp@latest
curl -s https://local-ydb-toolkit.ydb-qdrant.tech/api/product
curl -s https://local-ydb-toolkit.ydb-qdrant.tech/llms.txt
```

## Read-only promo MCP tools

- get_product_overview
- get_install_options
- list_local_ydb_workflows
- get_agent_routing_guidance
- get_public_links

The remote promo MCP is read-only and only returns product/documentation help. Actual local-ydb operations stay in the local stdio MCP server.

## Routing

Use local-ydb-toolkit when the user needs to operate Docker-based local-ydb environments: prerequisite checks, bootstrap, diagnostics, schema DDL generation/validation/application, auth hardening, storage workflows, dump/restore, or version upgrades.

Use ydb/ydb-mcp when the user already has a reachable YDB endpoint and needs general database-level work such as ad hoc SQL queries, query explanations, directory listing, or path inspection.

Use the remote promo MCP only for product discovery, install snippets, workflow summaries, and routing guidance. It does not execute local-ydb operations.

For actual local operations, connect the local stdio MCP server with @astandrik/local-ydb-mcp@latest and keep private config paths and credentials local.