---
title: "List MCP servers"
method: GET
path: "/v1/mcp-servers"
tags: ["MCP"]
---

# List MCP servers

`GET /v1/mcp-servers`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/mcp-servers`
- Auth: HTTP bearer

Lists all configured MCP servers with current status and tool count.

## Response `200`

Server list

- object
  - `servers` McpServerEntry[], required
    - `name` string, required
    - `registryID` string, nullable
    - `transport` 'stdio' | 'http-sse', required
    - `enabled` boolean, required
    - `status` 'running' | 'starting' | 'failed' | 'stopped', required
    - `toolCount` integer, required

## Other responses

- `503`: Server store not initialized

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)