SWIRLS_
ReferenceSDKClient

connectors

SDK reference for connectors —

listConnectors

List the MCP connectors provisioned for a project from its deployed connector blocks.

GET

Usage:

const result = await swirls.client.connectors.listConnectors({
  projectId: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes

Output:

FieldTypeDescription
connectorsobject[]

listCredentials

List the per-end-client credentials minted under a project (optionally filtered by connector). Never returns client secrets.

GET

Usage:

const result = await swirls.client.connectors.listCredentials({
  projectId: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
connectorNamestringNo

Output:

FieldTypeDescription
credentialsobject[]

mintCredential

Mint a named per-end-client credential under a connector. The client secret is returned once and never again.

POST

Usage:

const result = await swirls.client.connectors.mintCredential({
  projectId: '...',
  connectorName: '...',
  displayName: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
connectorNamestringYes
displayNamestringYes
redirectUrisstring[]No

Output:

FieldTypeDescription
credentialIdstring
clientIdstring
clientSecretstring

revokeCredential

Revoke a per-end-client credential: disable its OAuth application and delete its outstanding access tokens.

POST

Usage:

const result = await swirls.client.connectors.revokeCredential({
  projectId: '...',
  credentialId: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
credentialIdstringYes

Output:

FieldTypeDescription
revokedtrue

updateCredential

Replace the OAuth redirect URIs registered for a credential. The authorize endpoint validates redirect_uri against this set.

POST

Usage:

const result = await swirls.client.connectors.updateCredential({
  projectId: '...',
  credentialId: '...',
  redirectUris: [],
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
credentialIdstringYes
redirectUrisstring[]Yes

Output:

FieldTypeDescription
credentialobject

bindDynamicClient

Bind a dynamically-registered OAuth client (RFC 7591) to a connector, turning it into a per-end-client credential. One-shot: a bound client can never be rebound.

POST

Usage:

const result = await swirls.client.connectors.bindDynamicClient({
  projectId: '...',
  clientId: '...',
  connectorName: '...',
  displayName: '...',
})

Input:

ParameterTypeRequiredDescription
projectIdstringYes
clientIdstringYes
connectorNamestringYes
displayNamestringYes

Output:

FieldTypeDescription
credentialobject

getDynamicClientStatus

Whether an OAuth client is known, bound to a connector, and revoked. Booleans only; leaks no binding details.

GET

Usage:

const result = await swirls.client.connectors.getDynamicClientStatus({
  clientId: '...',
})

Input:

ParameterTypeRequiredDescription
clientIdstringYes

Output:

FieldTypeDescription
foundboolean
boundboolean
revokedboolean

On this page