Voice

Connect an MCP server

Register a Model Context Protocol server agents can call tools on.

transport_type decides which other field is required: sse needs connection_url, stdio needs command. It is closed to those two here.

env_vars IS A SECRET FIELD. It is write-only by convention on this surface - the read routes return the server's tools, not its environment - and anything put here is available to the process voice starts.

org_id is not in the body. Voice's own model requires it; it is supplied from the key, so a caller cannot register a server into another tenant.

post/voice/mcp-servers

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/mcp-servers
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring required
descriptionstring nullable
transport_type'sse' | 'stdio' required

sse for a remote server reached over HTTP, stdio for a local process.

connection_urlstring nullable

Required when transport_type is sse.

commandstring nullable

Required when transport_type is stdio.

argsstring[] nullable
env_varsobject nullable

Environment for the server process. WRITE-ONLY: values set here are never echoed back by the read routes.

enabledboolean

Response

Successful Response

dataVoicePayload required

One voice object - a collection, an agent, a route, a chat.

Open-shaped: voice adds fields to these bodies on its own release cadence and a dropped-or-added key must not be a 500 in this service.

Changes

No recorded changes to this operation across all 2 revisions of this API.