Skip to content

Commit 89b33cd

Browse files
Chris Garberclaude
authored andcommitted
docs: list every MCP tool and restore the MCP tab sidebar
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>
1 parent b36ff3a commit 89b33cd

2 files changed

Lines changed: 69 additions & 15 deletions

File tree

‎fern/docs.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1098,6 +1098,9 @@ navigation:
10981098
- page: MCP server
10991099
path: sdk/mcp-server.mdx
11001100
icon: fa-light fa-server
1101+
- link: MCP tools
1102+
href: /tools/mcp
1103+
icon: fa-light fa-network-wired
11011104

11021105
- tab: sdks
11031106
layout:

‎fern/sdk/mcp-server.mdx‎

Lines changed: 66 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -197,24 +197,75 @@ If your client can't connect to a remote server directly, run it through the `mc
197197

198198
## Core tools
199199

200-
The Vapi MCP Server exposes these tools:
201-
202-
| Tool | Description | Example usage |
203-
|------------------------|--------------------------------------------------|-----------------------------------------------|
204-
| `ask_vapi_docs` | Search Vapi documentation | Ask how a Vapi feature works |
205-
| `list_assistants` | List all Vapi assistants | Show all configured assistants |
206-
| `create_assistant` | Create a new Vapi assistant | Add a new assistant for a use case |
207-
| `get_assistant` | Get a Vapi assistant by ID | View assistant config |
208-
| `list_calls` | List all calls | Review call activity |
209-
| `create_call` | Create an outbound call (now or scheduled) | Initiate or schedule a call |
210-
| `get_call` | Get details for a specific call | Check status or result of a call |
211-
| `list_phone_numbers` | List all Vapi phone numbers | See available numbers |
212-
| `get_phone_number` | Get details of a specific phone number | Inspect a phone number |
213-
| `list_tools` | List all available Vapi tools | Tool discovery |
214-
| `get_tool` | Get details of a specific tool | Tool integration info |
200+
The Vapi MCP Server exposes these tools. The hosted server and the [local server](#run-the-server-locally) expose the same set.
201+
202+
### Documentation and reference
203+
204+
| Tool | Description |
205+
|------------------|-----------------------------------------------------------------------------|
206+
| `ask_vapi_docs` | Search Vapi documentation and return relevant passages with source URLs |
207+
| `get_api_schema` | Look up a schema in the Vapi API reference, the OpenAPI spec the SDKs are generated from |
208+
| `search_skills` | Find Vapi agent skills in the public `VapiAI/skills` repository |
209+
| `load_skill` | Read a public Vapi skill or one of its supporting files |
210+
211+
`load_skill` returns instructions for the agent to follow. It does not install skills or run scripts.
212+
213+
### Assistants
214+
215+
| Tool | Description |
216+
|--------------------|------------------------------------|
217+
| `list_assistants` | List all Vapi assistants |
218+
| `get_assistant` | Get a Vapi assistant by ID |
219+
| `create_assistant` | Create a new Vapi assistant |
220+
| `update_assistant` | Update an existing Vapi assistant |
221+
222+
### Calls
223+
224+
| Tool | Description |
225+
|---------------|------------------------------------|
226+
| `list_calls` | List all calls |
227+
| `get_call` | Get details for a specific call |
228+
| `create_call` | Create an outbound call, now or scheduled |
215229

216230
To schedule a call, pass the optional `scheduledAt` parameter to `create_call`. `create_call` places a real phone call.
217231

232+
### Phone numbers
233+
234+
| Tool | Description |
235+
|----------------------|----------------------------------------|
236+
| `list_phone_numbers` | List all Vapi phone numbers |
237+
| `get_phone_number` | Get details of a specific phone number |
238+
239+
### Vapi tools
240+
241+
| Tool | Description |
242+
|---------------|-----------------------------------|
243+
| `list_tools` | List all Vapi tools |
244+
| `get_tool` | Get details of a specific tool |
245+
| `create_tool` | Create a new Vapi tool |
246+
| `update_tool` | Update an existing Vapi tool |
247+
248+
### Simulations
249+
250+
These tools drive [simulations](/observability/simulations-overview), which test an assistant against scripted callers.
251+
252+
| Tool | Description |
253+
|----------------------------------|-----------------------------------------------------------------------------|
254+
| `list_simulation_personalities` | List simulation personalities, the simulated callers used in simulations |
255+
| `create_simulation_personality` | Create a simulated caller that talks to the assistant under test |
256+
| `list_simulation_scenarios` | List simulation scenarios, the scripts testers follow and the checks that decide pass or fail |
257+
| `create_simulation_scenario` | Create a scenario: tester instructions plus the evaluations that decide pass or fail |
258+
| `list_simulations` | List simulations, each pairing one scenario with one personality |
259+
| `create_simulation` | Create a simulation that pairs a scenario with a personality |
260+
| `list_simulation_suites` | List simulation suites, which are named groups of simulations |
261+
| `create_simulation_suite` | Create a suite that groups simulations so they can be run together |
262+
| `run_simulations` | Start a run of simulations or suites against an assistant or squad |
263+
| `list_simulation_runs` | List simulation runs, newest first |
264+
| `get_simulation_run` | Get a run with its status, item counts, and item summaries |
265+
| `get_simulation_run_item` | Get one run item in full, including results, call snapshots, and transcript |
266+
267+
`run_simulations` places real calls against the assistant you point it at.
268+
218269
## Use the server from your own code
219270

220271
Connect any MCP client to `https://mcp.vapi.ai/mcp` over Streamable HTTP, and send your Vapi API key in the `Authorization: Bearer YOUR_VAPI_API_KEY` header.

0 commit comments

Comments
 (0)