Install with one command
add-mcp scans your machine for installed MCP clients (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf…), shows a checklist of which ones to wire up, writes the right config block to each, and prompts you to restart anything that needs it. The command is idempotent - re‑run it any time you install a new client.
Server endpoint
- Transport: Streamable HTTP (no auth, public).
- What it exposes: Read-only full-text search and page fetch across the Vobiz documentation site, plus a
submit_feedbacktool that creates a documentation feedback report. - What it is not: This server reads the documentation only. To let an AI client place calls, send messages and manage your account, use the Vobiz MCP server; for direct programmatic access, use the API Reference.
Discover the server automatically
MCP clients can use the public discovery metadata:- Server card:
https://www.vobiz.ai/.well-known/mcp/server-card.json - Endpoint:
https://www.vobiz.ai/docs/mcp
Server identity
Available tools
The MCP server provides documentation context. It does not expose your Vobiz account, API credentials, calls, phone numbers, trunks, or billing data.
Prerequisites
- An MCP‑aware client (Claude Desktop, Claude Code, Cursor, VS Code 1.99+, etc.).
- Node.js 18+ for
npx. Ifnode --versionprintsv18or higher, you’re set. - An internet connection - the server is hosted, nothing runs locally.
Manual setup per client
If you’d rather wire each client up by hand (oradd-mcp didn’t detect yours), the sections below show the exact config for each.
Claude Desktop
Claude Desktop connects to the hosted endpoint as a custom connector.1
Add a custom connector
Open Settings → Connectors, click Add custom connector, name it
vobiz-docs, and paste https://www.vobiz.ai/docs/mcp as the URL. No sign-in is needed.2
Try it
Ask Claude:
Using the vobiz-docs connector, how do I start an audio stream from XML?Claude calls
search_vobiz and query_docs_filesystem_vobiz and answers from the live docs.Fallback: config file with mcp-remote
If your Claude Desktop build has no custom connectors, wrap the hosted HTTP endpoint with mcp-remote in the config file. No global install needed - npx fetches it on first run.
1
Open the config file
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{} as its content.2
Add the Vobiz server
Merge this block into your config:
claude_desktop_config.json
3
Restart Claude Desktop
Quit Claude fully (⌘Q on macOS) and reopen it. The new tools surface under the 🔌 / hammer icon in the prompt bar - you should see
search_vobiz, query_docs_filesystem_vobiz and submit_feedback listed under vobiz-docs.Claude Code
Claude Code (the CLI) speaks Streamable HTTP natively - nomcp-remote shim required.
1
Add the server
Run from any project directory:Use
--scope user to make the server available across every project, or --scope project to commit the config alongside the repo:2
Verify it loaded
vobiz-docs should appear with a ✓ next to it. Inside a session, type /mcp to see live status and the tools the server exposes.3
Use it in a session
Anywhere in a Claude Code conversation:
Look up the <Stream> XML attributes in the Vobiz docs and write me a minimal handler.
Claude Code calls search_vobiz and query_docs_filesystem_vobiz automatically (shown as mcp__vobiz-docs__search_vobiz and mcp__vobiz-docs__query_docs_filesystem_vobiz).Cursor
Cursor reads MCP servers from~/.cursor/mcp.json (global) or .cursor/mcp.json (per‑project).
1
Edit the MCP config
Open Cursor → Settings → MCP → Edit Config, or edit the file directly:
~/.cursor/mcp.json
2
Enable & test
Back in Settings → MCP, toggle
vobiz-docs on. The status dot should turn green within a few seconds. Open a new chat and ask a Vobiz‑specific question - Cursor surfaces an “MCP” badge when it pulls from the server.VS Code
VS Code 1.99+ has first‑class MCP support behind the Copilot Chat → Agent mode.1
Create the workspace config
Inside your project, create Prefer a global setup? Run the MCP: Add Server command from the palette (⇧⌘P) and paste the same URL.
.vscode/mcp.json:.vscode/mcp.json
2
Use it in agent mode
Open the Copilot Chat panel, switch to Agent, and click the 🛠 tools menu - enable
vobiz-docs. Ask the agent anything about Vobiz and it will fetch from the docs automatically.Any other MCP client
The hosted URL works with any client that speaks Streamable HTTP. Two common one‑off invocations:Run mcp-remote directly
Probe with the MCP Inspector
search_vobiz with a query, and inspect raw JSON‑RPC traffic - handy when integrating a brand‑new client.
Verify the connection
A quick sanity check that works in any client:
Use the Vobiz Docs MCP server to find the page that documents the playedStream event, then quote its first paragraph.
If the assistant returns content from /xml/stream/stream-events, the connection is healthy. If it answers from memory (or gets details wrong), the server isn’t actually wired up - re‑check the config file and restart the client.
Troubleshooting
- Claude Desktop shows no tools after editing the config. Fully quit (⌘Q / right‑click → Quit). A window close alone keeps the process alive and the old config cached.
npx: command not found. Install Node.js 18+. On macOS with Homebrew:brew install node.mcp-remoteerrors out on first run. Clear the npx cache:rm -rf ~/.npm/_npxand try again. Corporate proxies sometimes block the npm registry - setHTTPS_PROXYaccordingly.- Claude Code says
Server failed to connect. Runclaude mcp listto see the current entry, remove it withclaude mcp remove vobiz-docs, then re‑add. The--transport httpflag is required - without it the CLI assumes stdio. - VS Code: tools menu is empty. You’re not in Agent mode. Switch the Copilot Chat dropdown from Ask to Agent; MCP tools only surface there.
Related
- Vobiz API reference - discover the API docs, OpenAPI specification, SDKs, Agent Skills, and developer console.
- OpenAPI specification - generate clients and inspect the full REST API contract.
- Vobiz Agent Skills - install reusable workflows for Claude, Codex, and other coding agents.
- Vobiz CLI - search these docs from your terminal with
vobiz docs search, and set up MCP servers and skills for your agents. - Vobiz SDKs - official client libraries and example applications.
- Claude Code docs - official setup and
claude mcpreference. - Model Context Protocol spec - protocol details, transports, and SDKs.
- Vobiz Partner API - for programmatic access to accounts, CDRs, and KYC, separate from the docs MCP server.