Skip to content

docs: list every MCP tool and restore the MCP tab sidebar - #1413

Merged
chris-garber-vapi merged 1 commit into
claude/mcp-server-hosted-firstfrom
claude/mcp-tools-table-sidebar
Nov 10, 2026
Merged

chris-garber-vapi merged 1 commit into
claude/mcp-server-hosted-firstfrom
claude/mcp-tools-table-sidebar

Conversation

@chris-garber-vapi

Copy link
Copy Markdown
Contributor

Stacked on #1410, below #1411. Two fixes to the MCP server page.

The tools table was missing 18 of 29 tools

The hosted server pins @vapi-ai/mcp-server at 0.1.0 and calls registerAllTools, so the hosted and local servers expose the same 29 tools. The page listed 11.

Added: update_assistant, create_tool, update_tool, get_api_schema, search_skills, load_skill, and the 12 simulation tools (list_simulation_personalities through get_simulation_run_item). Descriptions are taken from each tool's own registered description rather than invented.

I grouped the table by area — documentation and reference, assistants, calls, phone numbers, Vapi tools, simulations — because one flat 29-row table is hard to scan, and dropped the "Example usage" column, which was invented filler that gets worse at 29 rows. Flagging that as an editorial call rather than a pure addition.

Two safety notes added, matching the existing create_call one: run_simulations places real calls, and load_skill returns instructions without installing anything or running scripts.

get_connection_info is deliberately not here. It is registered by the hosted server itself, not the package, and only exists in the OAuth build — so it belongs to #1411, where it already is.

The MCP tab rendered no sidebar

#fern-sidebar was display: none on /sdk/mcp-server, while every other tab rendered display: flex.

Cause: #1396 ("Updated the MCP tools pages") moved tools/mcp.mdx out of the MCP tab into the Documentation tab as a section. That left the MCP tab with exactly one entry, and Fern renders no sidebar for a tab with one entry. For comparison, the SDKs tab has 1 page and 11 links and renders fine — it is the entry count, not the page count.

So this is a regression from #1396, not from the recent MCP page work, and it is live on main today.

Fix: add a link back to MCP tools in the MCP tab, which restores both the sidebar and the cross-link #1396 removed.

Verified against a local fern docs dev server: #fern-sidebar goes from display: none to display: flex, showing "MCP server" (highlighted) and "MCP tools".

Verification

  • fern check --local — 0 errors, 19 warnings, all pre-existing.
  • fern docs broken-links — only the pre-existing quickstart/introduction.mdx:169 → /config-as-code.md. The new /tools/mcp and /observability/simulations-overview links resolve.
  • Local dev server: all 6 tables render, 29 tool rows total.

🤖 Generated with Claude Code

The tools table listed 11 of the 29 tools the server registers, and the
MCP tab rendered no sidebar.

Tools: the hosted server pins @vapi-ai/mcp-server 0.1.0 and registers all
of its tools, so hosted and local expose the same 29. The 18 that were
missing are update_assistant, create_tool, update_tool, get_api_schema,
search_skills, load_skill and the 12 simulation tools. Descriptions come
from the tools' own registered descriptions. Grouped the table by area,
since one flat 29-row table is hard to scan, and dropped the invented
"Example usage" column.

Sidebar: #1396 moved tools/mcp.mdx out of the MCP tab into the
Documentation tab, leaving the tab with a single page. Fern renders no
sidebar for a tab with one entry, so #fern-sidebar was display:none on
this page while every other tab was display:flex. Adding a link back to
MCP tools restores the sidebar and the cross-link #1396 removed.
Verified against a local fern docs dev server.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

@chris-garber-vapi
chris-garber-vapi merged commit 89b33cd into claude/mcp-server-hosted-first Nov 10, 2026
5 of 6 checks passed
@chris-garber-vapi

Copy link
Copy Markdown
Contributor Author

Collapsed into #1410 rather than reviewed separately.

GitHub marked this as merged automatically: its only commit (89b33cd3) is now contained in its base branch, claude/mcp-server-hosted-first, so nothing was merged into main here. #1410 carries that commit unchanged and its description now covers the tools-table and sidebar work. #1411 is restacked directly onto #1410.

Review #1410 instead.

@chris-garber-vapi
chris-garber-vapi deleted the claude/mcp-tools-table-sidebar branch November 10, 2026 19:17
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