v3

latestOpenAPI 3.0.02026-08-081996601.2 MB

Tool Servers

List tool servers

Lists the tool servers in the account. A tool server exposes tools that agents can use.

get/v2/tool_servers

Query parameters

filterstring

Example:rag.*

A regular expression against tool server names and descriptions to filter the results.

type'mcp'

Example:mcp

Filter tool servers by type.

enabledboolean

Example:true

Filter tool servers by enabled status.

limitinteger

The maximum number of tool servers to return in the list.

page_keystring

The opaque cursor returned in metadata.page_key of the previous response. Omit it to fetch the first page.

Headers

Request-Timeoutinteger

The platform makes a best effort to complete the request in the specified seconds, or it times out.

Request-Timeout-Millisinteger

The platform makes a best effort to complete the request in the specified milliseconds, or it times out.

Response

List of available tool servers.

Example response

{
  "tool_servers": [
    {
      "id": "tsr_rag_search",
      "name": "RAG Search Server",
      "type": "mcp",
      "description": "Provides RAG search capabilities for documents.",
      "uri": "https://api.example.com/sse/",
      "headers": {
        "Content-Type": "application/json"
      },
      "transport": "sse",
      "metadata": {
        "version": "1.0"
      }
    }
  ],
  "metadata": {
    "page_key": "eyJvZmZzZXQiOjF9"
  }
}