SWIRLS_
ReferenceSDKClient

mcpServers

SDK reference for mcpservers —

listSlots

List MCP server slots from the latest deployment with binding status (no token values). Bindings whose slot is not in the latest deployment appear flagged as orphaned.

GET

Usage:

const result = await swirls.client.mcpServers.listSlots({
  projectId: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes

Output:

FieldTypeDescription
slotsobject[]
grantsUnavailableboolean

upsertBinding

Bind or update an MCP server slot. For DSL-backed slots, save token only (URL comes from the deployment). For legacy slots, provide a remote URL (SSRF-validated). Token is encrypted at rest. Omit token to keep the existing one; set clearToken to remove it.

POST

Usage:

const result = await swirls.client.mcpServers.upsertBinding({
  projectId: '...',
  name: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
namestringYes
urlstringNo
tokenstringNo
authHeaderstringNo
clearTokenbooleanNo

Output:

FieldTypeDescription
savedtrue

deleteBinding

Remove the binding for an MCP server slot.

POST

Usage:

const result = await swirls.client.mcpServers.deleteBinding({
  projectId: '...',
  name: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
namestringYes

Output:

FieldTypeDescription
deletedtrue

testBinding

Connect to the bound MCP endpoint out of band and list its advertised tools (names capped at 25), validating reachability and credentials.

POST

Usage:

const result = await swirls.client.mcpServers.testBinding({
  projectId: '...',
  name: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
namestringYes

Output:

FieldTypeDescription
okboolean
toolCountnumber
toolNamesstring[]
errorstring

startOAuth

Start interactive OAuth Connect for an auth: interactive MCP slot.

POST

Usage:

const result = await swirls.client.mcpServers.startOAuth({
  projectId: '...',
  name: '...',
  returnUrl: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
namestringYes
returnUrlstringYes

Output:

FieldTypeDescription
authorizationUrlstring
statestring

bindOAuth

Confirm an interactive MCP grant after the Fabric OAuth callback.

POST

Usage:

const result = await swirls.client.mcpServers.bindOAuth({
  projectId: '...',
  oauthState: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
oauthStatestringYes

Output:

FieldTypeDescription
boundtrue

disconnectInteractive

Disconnect an interactive MCP grant (Fabric unbind).

POST

Usage:

const result = await swirls.client.mcpServers.disconnectInteractive({
  projectId: '...',
  name: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
namestringYes

Output:

FieldTypeDescription
disconnectedtrue

On this page