Skip to main content
POST
Create an MCP server

Authorizations

Authorization
string
header
required

Your Wixzel Voice API key: Authorization: Bearer wv_live_.... Keys are scoped; grant only what the integration needs.

Body

application/json
name
string
required

What the agent is told the app is called, so make it the name a caller would recognise.

Required string length: 1 - 100
Example:

"HubSpot"

url
string<uri>
required

The server’s remote MCP endpoint (Streamable HTTP or SSE). Must be public https or http on port 443 or 80.

Maximum string length: 2048
Example:

"https://mcp.example.com/mcp"

transport
enum<string>
default:auto

auto tries Streamable HTTP, then falls back to SSE.

Available options:
auto,
streamable_http,
sse
auth
object
enabled_tools
string[]

Names of the tools agents may call. Replaced as a whole when sent. When never set, the first discovery enables only the tools the server marks read-only; anything that writes has to be switched on deliberately.

Maximum array length: 100
Required string length: 1 - 128

Response

The created an MCP server

id
string
required
Pattern: ^[0-9a-f]{24}$
Example:

"6a96a3ead6e886d42462dd3e"

object
enum<string>
required
Available options:
mcp_server
name
string
required
url
string
required
transport
enum<string>
required
Available options:
auto,
streamable_http,
sse
auth
object
required
status
enum<string>
required

ready once its tools have been read. needs_auth until an OAuth server is connected, or after its sign-in expires. error when it could not be reached; last_error says why. Agents only use servers that are ready.

Available options:
pending,
ready,
needs_auth,
error
last_error
string | null
required
server_info
object | null
required
tools
object[]
required
tools_refreshed_at
string<date-time> | null
required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"

created_at
string<date-time>
required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"