---
title: "List tool servers"
method: GET
path: "/v2/tool_servers"
tags: ["Tool Servers"]
---

# List tool servers

`GET /v2/tool_servers`

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

## Query parameters

- `filter` string
- `type` 'mcp'
- `enabled` boolean
- `limit` integer
- `page_key` string

## Headers

- `Request-Timeout` integer
- `Request-Timeout-Millis` integer

## Response `200`

List of available tool servers.

- ListToolServersResponse — Response containing a list of tool servers.
  - `tool_servers` ToolServer[], required — List of tool servers.
    - `id` string — Unique identifier for a tool server.
    - `name` string, required — The human-readable name of a tool server.
    - `type` 'mcp', required — The type of tool server.
    - `description` string — A detailed description of what this tool server does.
    - `uri` string, uri, required — The URI of the server.
    - `headers` object — Optional HTTP headers to include when connecting to the server.
    - `transport` 'sse' | 'streamable-http', required — Transport protocol for MCP server connections. Both use Server-Sent Events (SSE). - `sse`: Legacy format (https://modelcontextprotocol.io/specification/2024-11-05/basic/transports) - `streamable-http`: New format (https://modelcontextprotocol.io/specification/2025-03-26/basic/transports)
    - `enabled` boolean, required — Whether the tool server is currently enabled and available for use.
    - `metadata` object — Arbitrary metadata associated with the tool server.
    - `created_at` string, date-time — Timestamp when the tool server was created.
    - `updated_at` string, date-time — Timestamp when the tool server was last updated.
  - `metadata` ListMetadata — The standard metadata in the response of a list operation.
    - `page_key` string — The page key for the next page of results. Pass it as a query parameter to request the next page.

## Other responses

- `403` — Permissions do not allow listing tool servers.

---

[API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/revisions/a95087fe3a20/schema)