---
title: "List virtual MCP servers (config-declared and admin-managed)"
method: GET
path: "/admin/mcp-virtual-servers"
tags: ["admin"]
---

# List virtual MCP servers (config-declared and admin-managed)

`GET /admin/mcp-virtual-servers`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/admin/mcp-virtual-servers`
- Auth: HTTP bearer

Each virtual server serves a subset of the MCP servers at /mcp/{name}. missing_servers lists members no server matches; conflict explains why a virtual server is not served.

## Response `200`

OK

- AdminMcpVirtualServerResponse[]
  - `configured_tool_discovery` string: ConfiguredToolDiscovery is the stored setting: "off", "search", or "" to inherit the gateway default. ToolDiscovery is the effective mode.
  - `conflict` string
  - `description` string
  - `managed` boolean
  - `missing_servers` string[]
  - `name` string
  - `servers` string[]
  - `tool_discovery` string

## Other responses

- `401`: Unauthorized
- `503`: Service Unavailable

## Changes

- **2026-10-20** `b6dc69ca9610`: 2 info
  - added the optional property `items/configured_tool_discovery` to the response with the `200` status
  - added the optional property `items/managed` to the response with the `200` status
- **2026-10-03** `2f793e1bbb84`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/enterpilot/apis/gomodel-api/changes/admin/mcp-virtual-servers/get.md)

---

[API](https://skmtc.dev/enterpilot/apis/gomodel-api.md) - [All operations](https://skmtc.dev/enterpilot/apis/gomodel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/enterpilot/apis/gomodel-api/revisions/02d5643d7bec?raw)