Skip to main content
POST
Refresh an MCP server’s tools

Authorizations

Authorization
string
header
required

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

Path Parameters

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

"6a96a3ead6e886d42462dd3e"

Response

The server, with its current tools

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"