Create

Create creates a Raw-tools Virtual MCP Server from one Hosted or External MCP source or an initially empty Assigned-tools catalog.

POST /api/v1/virtual_mcp_servers

Create

cURL

curl --request POST \
  --url https://{tenantDomain}.conductor.one/api/v1/virtual_mcp_servers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allowPersonalSources": true,
  "assignedTools": {},
  "displayName": "<string>",
  "mappedSource": {
    "appId": "<string>",
    "connectorId": "<string>"
  },
  "presentation": {
    "codeMode": {},
    "dynamicTools": {},
    "rawTools": {}
  },
  "requireDeviceTrust": true,
  "requireDpop": true,
  "slug": "<string>"
}
'

200

{
  "virtualMcpServer": {
    "allowPersonalSources": true,
    "assignedTools": {},
    "createdAt": "2023-11-07T05:31:56Z",
    "displayName": "<string>",
    "id": "<string>",
    "mappedSource": {
      "appId": "<string>",
      "connectorId": "<string>"
    },
    "presentation": {
      "codeMode": {},
      "dynamicTools": {},
      "rawTools": {}
    },
    "requireDeviceTrust": true,
    "requireDpop": true,
    "slug": "<string>",
    "state": "VIRTUAL_MCP_SERVER_STATE_UNSPECIFIED",
    "updatedAt": "2023-11-07T05:31:56Z",
    "useEntitlementId": "<string>"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization · string · header · required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

VirtualMCPServerServiceCreateRequest creates an active Virtual MCP Server with Raw tool presentation and either a mapped source or explicit tool assignments.

This message contains a oneof named composition. Only a single field of the following list may be set at a time:

• mappedSource
• assignedTools

allowPersonalSources · boolean

Permit owner-scoped personal MCP sources on supported compositions.

assignedTools · Virtual Mcp Assigned Tools · object | null

VirtualMCPAssignedTools marks a Virtual MCP Server composed from selected Toolsets and individual tools.

displayName · string

Human-readable name shown to administrators and users.

mappedSource · Virtual Mcp Mapped Source · object | null

VirtualMCPMappedSource identifies one app-scoped MCP source.

Show child attributes

presentation · Virtual Mcp Presentation · object | null

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

Show child attributes

requireDeviceTrust · boolean

When true, require an active ConductorOne-managed device in addition to DPoP. require_device_trust=true requires require_dpop=true.

requireDpop · boolean

When true, require DPoP proof-of-possession for OAuth access tokens.

slug · string

Initial canonical lowercase route segment, unique for the tenant.

Response

200 - application/json

VirtualMCPServerServiceCreateResponse contains the created Virtual MCP Server.

VirtualMCPServerServiceCreateResponse contains the created Virtual MCP Server.

virtualMcpServer · Virtual Mcp Server · object | null

VirtualMCPServer is a tenant-managed MCP endpoint backed by one composition.

This message contains a oneof named composition. Only a single field of the following list may be set at a time:

• mappedSource
• assignedTools

Show child attributes