---
title: "List all clients status"
method: GET
path: "/api/v1beta/discovery/clients"
tags: ["discovery"]
---

# List all clients status

`GET /api/v1beta/discovery/clients`

List all clients compatible with ToolHive and their status.
Each object includes supports_skills when ToolHive can install skills for that client.

## Response `200`

OK

- PkgApiV1ClientStatusResponse
  - `clients` GithubComStacklokToolhivePkgClientClientAppStatus[]
    - `client_type` 'roo-code' | 'cline' | 'cursor' | 'vscode-insider' | 'vscode' | 'claude-code' | 'windsurf' | 'windsurf-jetbrains' | 'amp-cli' | 'amp-vscode' | 'amp-cursor' | 'amp-vscode-insider' | 'amp-windsurf' | 'lm-studio' | 'goose' | 'trae' | 'continue' | 'opencode' | 'kiro' | 'antigravity' | 'zed' | 'gemini-cli' | 'vscode-server' | 'mistral-vibe' | 'codex' — ClientType is the type of MCP client
    - `installed` boolean — Installed indicates whether the client is installed on the system
    - `registered` boolean — Registered indicates whether the client is registered in the ToolHive configuration
    - `supports_skills` boolean — SupportsSkills indicates whether ToolHive can install skills for this client

## Changes

- **2026-04-13** `9d90f835d94c` — 1 info
  - added the optional property `clients/items/supports_skills` to the response with the `200` status
- **2026-02-09** `a00c1abcef71` — 3 warning
  - added the new `codex` enum value to the `clients/items/client_type` response property for the response status `200`
  - added the new `mistral-vibe` enum value to the `clients/items/client_type` response property for the response status `200`
  - added the new `vscode-server` enum value to the `clients/items/client_type` response property for the response status `200`
- **2026-02-05** `0ab796b83fa1` — 1 warning
  - added the new `gemini-cli` enum value to the `clients/items/client_type` response property for the response status `200`
- **2026-01-29** `ff6ce8dd8f3a` — 6 warning, 7 info
  - removed the optional property `clients/items/supports_plugins` from the response with the `200` status
  - removed the optional property `clients/items/supports_skills` from the response with the `200` status
  - added the new `amp-cursor` enum value to the `clients/items/client_type` response property for the response status `200`
  - added the new `amp-vscode` enum value to the `clients/items/client_type` response property for the response status `200`
  - …9 more

[Change history](https://skmtc.dev/stacklok/apis/toolhive-api/changes/api/v1beta/discovery/clients/get.md)

---

[API](https://skmtc.dev/stacklok/apis/toolhive-api.md) · [All operations](https://skmtc.dev/stacklok/apis/toolhive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacklok/toolhive-api/revisions/3b31034fd29e/schema)