fix(api): drop mcpEndSession from openapi and delete stale MCP_TOOLS.md

Merged
SA
4mo ago
+0-323

Part of the MCP v2 rework (Phase 0b).

  • Removes the mcpEndSession DELETE operation from the hand-authored openapi.json — the v2 MCP transport is stateless (no sessionIdGenerator), so there is no session to terminate and the advertised operation was a lie.
  • Deletes apps/api/MCP_TOOLS.md: a 306-line pre-implementation design doc documenting v1-era tool names (create_task, create_worktree), an X-API-Key auth scheme that never shipped, and 12 tools against the real 31. Nothing references it.

No behavior change.

https://claude.ai/code/session_01Kub4p3Eim9pc1qaRRmGea2


Open in Stage

Summary by cubic

Removed the mcpEndSession DELETE operation from the OpenAPI spec and deleted the outdated apps/api/MCP_TOOLS.md design doc. MCP v2 transport is stateless, so session termination is invalid; no runtime behavior changes.

Summary by CodeRabbit

  • Documentation

    • Removed the Superset MCP server tools documentation.
  • API Changes

    • Removed OpenAPI documentation for terminating MCP sessions through the DELETE endpoint.
    • MCP stream access documentation remains available.