---
title: "NOTE: Only shows Virtual MCP Servers available to the current user."
method: POST
path: "/api/v1/search/my_virtual_mcp_servers"
tags: ["Virtual MCP Servers"]
---

# NOTE: Only shows Virtual MCP Servers available to the current user.

`POST /api/v1/search/my_virtual_mcp_servers`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/search/my_virtual_mcp_servers`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Search live Virtual MCP Servers for which the caller's own principal has
 an active `use` grant. Results are ordered by display name and server ID
 and may briefly lag writes because search reads the PostgreSQL projection;
 connection authorization always rechecks authoritative state.

## Request body

- C1ApiAiGovernanceV1VirtualMCPServerMySearchServiceSearchRequest: VirtualMCPServerMySearchServiceSearchRequest searches Virtual MCP Servers the caller's own principal has a live `use` grant for. Only user principals may call this API.
  - `pageSize` integer: Maximum number of matching servers to return. The maximum is 100.
  - `pageToken` string: Opaque token that continues the PostgreSQL-backed search.

## Response `200`

VirtualMCPServerMySearchServiceSearchResponse contains one page of the
 caller's currently available Virtual MCP Servers.

- C1ApiAiGovernanceV1VirtualMCPServerMySearchServiceSearchResponse: VirtualMCPServerMySearchServiceSearchResponse contains one page of the caller's currently available Virtual MCP Servers.
  - `list` C1ApiAiGovernanceV1MyVirtualMCPServer[], nullable: Available Virtual MCP Servers in this page.
    - `displayName` string: Human-readable server name.
    - `id` string: Immutable unique identifier for this Virtual MCP Server.
    - `presentation` C1ApiAiGovernanceV1VirtualMCPPresentation: VirtualMCPPresentation selects one presentation mode and provides a stable location for mode-specific settings. This message contains a oneof named mode. Only a single field of the following list may be set at a time: - rawTools - codeMode - dynamicTools
      - `codeMode` C1ApiAiGovernanceV1VirtualMCPCodeModePresentation: VirtualMCPCodeModePresentation configures code-execution presentation.
      - `dynamicTools` C1ApiAiGovernanceV1VirtualMCPDynamicToolsPresentation: VirtualMCPDynamicToolsPresentation configures a session-specific tool registry.
      - `rawTools` C1ApiAiGovernanceV1VirtualMCPRawToolsPresentation: VirtualMCPRawToolsPresentation configures direct tool presentation.
    - `requireDeviceTrust` boolean: Whether every request also requires an active ConductorOne-managed device.
    - `requireDpop` boolean: Whether every request requires a proof-bound DPoP access token.
    - `slug` string: Current canonical lowercase route segment. Renaming preserves the previous slug as a deprecated alias until it is reused.
    - `url` string: Exact MCP-host URL an agent connects to.
  - `nextPageToken` string: Opaque token that continues the PostgreSQL-backed search.

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/search/my_virtual_mcp_servers/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)