ktx/docs/superpowers/plans
Andrey Avtomonov b759a4a286
feat(mcp):added MCP server (#97)
* docs(specs): design research-agent MCP tools and ktx mcp daemon

Adds the 2026-05-14 design spec for exposing four new MCP tools
(discover_data, entity_details, dictionary_search, sql_execution),
shipping a ktx-research skill, and introducing an HTTP-only ktx mcp
daemon so external agents can use KTX as a research-capable context
layer.

* Refine research-agent MCP tools spec after adversarial review iteration 1

* Refine research-agent MCP tools spec after adversarial review iteration 2

* Refine research-agent MCP tools spec after adversarial review iteration 3

* Refine spec: drop connectionName compat carve-out and ground summary/snippet provenance per kind

* feat(daemon): validate read-only SQL with sqlglot

* feat(context): expose read-only SQL validation port

* feat(context): register MCP sql execution tool

* feat(context): execute MCP SQL through validated connector path

* test(context): update SQL analysis port fixtures

* docs: add research-agent MCP sql execution foundation plan

* feat(context): add scan-backed entity details service

* feat(context): register MCP entity details tool

* feat(context): expose local MCP entity details

* test(context): align entity details scan fixtures

* docs: add research-agent MCP entity_details plan

* feat(context): add dictionary search service

* feat(context): register MCP dictionary search tool

* feat(context): expose local MCP dictionary search

* docs: add research-agent MCP dictionary_search plan

* feat: add MCP discover data service

* feat: expose discover data MCP tool

* feat: wire local discover data MCP port

* docs: add research-agent MCP discover_data plan

* feat(cli): add mcp http security helpers

* feat(cli): host mcp over streamable http

* feat(cli): manage mcp daemon lifecycle

* feat(cli): add ktx mcp commands

* fix(cli): stabilize mcp daemon verification

* docs: add research-agent MCP http daemon plan

* feat(cli): install KTX research skill

* feat(cli): configure MCP clients in setup agents

* feat(cli): support Claude local MCP setup scope

* docs: add research-agent MCP setup-agents plan

* refactor(context): use connectionId in warehouse verification tools

* docs(context): update ingest verification prompts for connectionId

* docs: add research-agent MCP ingest contract convergence plan

* chore: build runtime artifacts in conductor setup

---------

Co-authored-by: Andrey Avtomonov <7889985+andreybavt@users.noreply.github.com>
2026-05-15 02:35:09 +02:00
..
2026-05-11-agent-friendly-docs-site.md docs: plan agent-friendly docs site 2026-05-11 16:38:15 -07:00
2026-05-11-bundled-python-runtime-wheel.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-demo-guided-tour.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-11-historic-sql-cross-dialect-readiness.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-docs-smoke-and-config-cleanup.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-11-historic-sql-end-to-end-retrieval-acceptance.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-foundations.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-pattern-shard-smoke-docs.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-pattern-workunit-sharding.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-projection-archive-hardening.md docs(plans): add historic-sql projection archive hardening plan 2026-05-11 19:48:33 +02:00
2026-05-11-historic-sql-redaction-hardening.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-redesign-manual-test-plan.md Fix historic SQL ingest setup and progress 2026-05-11 22:35:07 +02:00
2026-05-11-historic-sql-search-enrichment.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-skills-projection-cutover.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-unified-hot-path.md docs(plans): add historic-sql unified hot-path plan 2026-05-11 17:55:42 +02:00
2026-05-11-managed-agent-mcp-semantic-runtime.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-embeddings-release-smoke.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-embeddings-runtime.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-embeddings-smoke-public-version.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-ingest-daemon-runtime.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-command-integration.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-daemon-lifecycle.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-installer.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-release-smoke.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-runtime-docs-and-postgres-smoke-cleanup.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-runtime-prune-smoke-and-docs.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-runtime-uv-prerequisite-contract.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-public-kaelio-ktx-npm-package.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-public-npm-release-handoff.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-published-package-managed-runtime-smoke.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-single-public-runtime-artifact-cleanup.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-12-notion-warehouse-verification-gap-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-12-warehouse-verification-final-v1-closure.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-12-warehouse-verification-tools.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-13-cli-command-tree-script.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-13-unified-ingest-public-cli-surface.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-docs-site-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-final-public-surface-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-final-ux-labels.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-foreground-and-retry-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-progress-copy-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-public-output-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-public-plain-output-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-query-history-status-cleanup.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-verification-copy-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-warehouse-verification-prompt-shape-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-13-warehouse-verification-sql-example-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-13-warehouse-verification-structured-target-miss-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-14-connection-driver-discriminated-union.md feat(context): add driver-discriminated connection schemas (#96) 2026-05-15 00:08:11 +02:00
2026-05-14-research-agent-mcp-dictionary-search.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-discover-data.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-entity-details.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-http-daemon.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-ingest-contract-convergence.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-setup-agents.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-sql-execution-foundation.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00