TAtavus
Connectors

Runtime Check Connector

Changed on

Check that a call can reach the server. A call reaches it differently from Preview Connector Tools, so a server can pass preview and still fail in a call. This lists the server's tools the way a call does. It never calls a tool.

A failure on the server's side is still a 200, with ok: false and the error. Limited to 10 checks per minute per account.

post/v2/connectors/{connector_id}/runtime_check

Request

  • Base URL
    https://tavusapi.com
  • URL
    https://tavusapi.com/v2/connectors/{connector_id}/runtime_check
  • Auth
    API key in header x-api-key

Response

The check ran. ok says whether the server's tools could be listed.

okboolean

true when the server's tools were listed. A conversation can reach this server.

tool_countinteger

How many tools were listed. 0 when ok is false.

tool_namesstring[]

The names of the tools that were listed.

latency_msinteger

How long the check took, in milliseconds.

Example response

{
  "ok": true,
  "tool_count": 3,
  "tool_names": [
    "search_messages",
    "list_channels",
    "post_message"
  ],
  "latency_ms": 1830,
  "error": {
    "http_status": 424,
    "message": "Error retrieving tool list from MCP server: 'linear'. Http status code: 424 (Failed Dependency)"
  }
}

Changes