Skip to content

docs(mcp): fix stale tool lists and counts in docs, marketing, and SDK reference - #6029

Merged
saddlepaddle merged 1 commit into
mainfrom
mcp-rework/0a-docs-drift
Jul 31, 2026
Merged

saddlepaddle merged 1 commit into
mainfrom
mcp-rework/0a-docs-drift

Conversation

@saddlepaddle

@saddlepaddle saddlepaddle commented Jul 28, 2026 •

Copy link
Copy Markdown
Collaborator

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

  • apps/docs mcp-server.mdx: capabilities table gains the missing Agents and Terminals rows; terminals tool table now lists all 5 tools (was only terminals_create).
  • apps/marketing llms.ts: drops the hardcoded "27 tools" (actual count is 31, and it will change again during the toolset rework) — points at the self-updating server card instead.
  • packages/sdk api.md: documents all five client.terminals.* methods and their types (only create was listed; the resource has shipped list/send/read/close for a while).

Docs-only, no behavior change.

https://claude.ai/code/session_01Kub4p3Eim9pc1qaRRmGea2


Open in Stage

Summary by cubic

Fixes stale MCP tool lists across docs, marketing, and SDK. Adds Agents/Terminals to capabilities, lists all terminal tools, documents client.terminals.{create,list,send,read,close}, and replaces the hardcoded tool count with the self-updating server card.

Docs-only; no behavior changes.

Written for commit 3950b1a. Summary will update on new commits.

Review in cubic

Summary by CodeRabbit

  • Documentation
    • Added documentation for agent capabilities, including listing agents and launching agent sessions in workspaces.
    • Expanded terminal tool coverage to include listing sessions, sending input, reading screens, and closing sessions.
    • Documented additional terminal session operations and their associated SDK methods.
    • Updated MCP server resources to reference the full tool catalog instead of a fixed tool count.

…K reference

The docs capabilities table omitted Agents and Terminals entirely, the
terminals tool table listed 1 of 5 tools, marketing llms.ts claimed 27
tools (actual: 31), and the SDK api.md documented only terminals.create
despite the resource shipping all five methods.

Claude-Session: https://claude.ai/code/session_01Kub4p3Eim9pc1qaRRmGea2
@ghost

ghost commented Jul 28, 2026

Copy link
Copy Markdown

Ready to review this PR? Stage has broken it down into 3 individual chapters for you:

Title
1 Update SDK reference for terminal methods
2 Sync MCP server documentation with current capabilities
3 Remove hardcoded tool counts from marketing content
Open in Stage

Chapters generated by Stage for commit 3950b1a on Jul 28, 2026 10:14pm UTC.

@coderabbitai

coderabbitai Bot commented Jul 28, 2026 •

Copy link
Copy Markdown
Contributor

Review Change Stack

📝 Walkthrough

Walkthrough

MCP documentation now lists agent and terminal capabilities, the SDK API reference documents terminal session operations, and marketing copy points to the full MCP server catalog.

Changes

MCP documentation

Layer / File(s) Summary
Terminal SDK API documentation
packages/sdk/api.md
Documents terminal request, response, summary types and client methods for listing, sending, reading, and closing sessions.
MCP capability and catalog descriptions
apps/docs/content/docs/mcp-server.mdx, apps/marketing/src/lib/llms.ts
Adds Agents and expanded Terminals capabilities to MCP documentation and replaces the outdated tool count with a full-catalog reference.

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title uses conventional commit style and clearly summarizes the docs-only MCP tooling updates.
Description check ✅ Passed The description covers the main changes and rationale, but it omits the testing section and checklist from the template.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch mcp-rework/0a-docs-drift

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/marketing/src/lib/llms.ts`:
- Line 56: Update the MCP server description in the marketing category list to
include the documented Organization capability, or revise the wording to
explicitly indicate the tools list is non-exhaustive while preserving the
existing description.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 74da554a-8667-4fe6-bccc-bd8d61ab1099

📥 Commits

Reviewing files that changed from the base of the PR and between 24eb5c1 and 3950b1a.

📒 Files selected for processing (3)
  • apps/docs/content/docs/mcp-server.mdx
  • apps/marketing/src/lib/llms.ts
  • packages/sdk/api.md

`- [API docs](${docsUrl}/mcp-server): Superset MCP server documentation`,
`- [OpenAPI spec](${API_URL}/openapi.json): OpenAPI 3.1 description of the Superset API surface`,
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — 27 tools for tasks, workspaces, agents, automations, terminals, hosts, and projects. Alias: ${API_URL}/mcp`,
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Keep the marketing category list aligned with the MCP documentation.

Line 56 omits the Organization capability, which is documented in apps/docs/content/docs/mcp-server.mdx at Line 25. Add organization to this list, or make the wording explicitly non-exhaustive (for example, “including tools for…”).

Suggested fix
-		`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,
+		`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, projects, and organization; full catalog in the server card. Alias: ${API_URL}/mcp`,
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, and projects; full catalog in the server card. Alias: ${API_URL}/mcp`,
`- [MCP server](${MCP_SERVER_URL}): Model Context Protocol server (Streamable HTTP transport) — tools for tasks, workspaces, agents, automations, terminals, hosts, projects, and organization; full catalog in the server card. Alias: ${API_URL}/mcp`,
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/marketing/src/lib/llms.ts` at line 56, Update the MCP server description
in the marketing category list to include the documented Organization
capability, or revise the wording to explicitly indicate the tools list is
non-exhaustive while preserving the existing description.

@github-actions

github-actions Bot commented Jul 28, 2026 •

Copy link
Copy Markdown
Contributor

🧹 Preview Cleanup Complete

The following preview resources have been cleaned up:

  • ✅ Neon database branch

Thank you for your contribution! 🎉

@saddlepaddle
saddlepaddle merged commit a7a36bf into main Jul 31, 2026
18 checks passed
@saddlepaddle
saddlepaddle deleted the mcp-rework/0a-docs-drift branch July 31, 2026 23:45

This branch was previously deployed

1 inactive deployment
preview — 3950b1ae Deployed Jul 28, 2026 by saddlepaddle via Deploy API #6913
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant