MCP Server
VoiceGateway includes a built-in [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that lets AI coding agents inspect, configure, and manage your voice AI gateway without leaving
MCP Server
VoiceGateway includes a built-in Model Context Protocol (MCP) server that lets AI coding agents inspect, configure, and manage your voice AI gateway without leaving their workflow.
What is MCP?
MCP is an open protocol that allows AI agents to use tools provided by external servers. When you connect an agent like Claude Code or Cursor to VoiceGateway's MCP server, the agent gains access to 17 tools for querying gateway state and performing administrative operations.
Tools Overview
The MCP server exposes tools in four categories:
Observability (read-only)
| Tool | Description |
|---|---|
get_health | Gateway health, uptime, version |
get_provider_status | Provider configuration status |
get_costs | Cost summary by period/project |
get_latency_stats | Latency percentiles and per-model stats |
get_logs | Recent request logs with filters |
Provider Management
| Tool | Description |
|---|---|
list_providers | List all configured providers |
get_provider | Details for one provider |
test_provider | Live connectivity test |
add_provider | Register a new provider |
delete_provider | Remove a managed provider (destructive) |
Model Management
| Tool | Description |
|---|---|
list_models | List all registered models |
register_model | Register a new model |
delete_model | Remove a managed model (destructive) |
Project Management
| Tool | Description |
|---|---|
list_projects | List projects with today's stats |
get_project | Full project details and cost trends |
create_project | Create a new project |
delete_project | Remove a managed project (destructive) |
Safety Features
Destructive tools (delete_provider, delete_model, delete_project) implement a two-phase confirmation pattern:
- Preview phase: Called without
confirm=True, the tool returns a preview of the impact (affected models, projects, total spend, etc.). - Confirm phase: Called with
confirm=True, the deletion is performed.
This ensures agents always show the user what will happen before making irreversible changes.
Quick Start
# Install MCP dependencies
pip install "voicegateway[mcp]"
# Start with stdio (for local agents)
voicegw mcp
# Start with HTTP/SSE (for remote agents)
VOICEGW_MCP_TOKEN=my-token voicegw mcp --transport http --port 8090Next Steps
- Setup guide -- configure Claude Code, Cursor, or Codex
- Transports -- stdio vs HTTP/SSE
- Authentication -- securing the HTTP transport
- Tool references: Observability, Providers, Models, Projects
What is VoiceGateway?
VoiceGateway is **a thin routing layer for LiveKit voice agents with first-class cost tracking and reconciliation**. It returns native LiveKit STT, LLM, and TTS plugin instances that drop straight int
Authentication
The MCP server supports optional Bearer token authentication for the HTTP/SSE transport. The stdio transport never checks authentication since it is only accessible to the local process that launched