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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes |
Output:
| Field | Type | Description |
|---|---|---|
connectors | object[] |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
connectorName | string | No |
Output:
| Field | Type | Description |
|---|---|---|
credentials | object[] |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
connectorName | string | Yes | |
displayName | string | Yes | |
redirectUris | string[] | No |
Output:
| Field | Type | Description |
|---|---|---|
credentialId | string | |
clientId | string | |
clientSecret | string |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
credentialId | string | Yes |
Output:
| Field | Type | Description |
|---|---|---|
revoked | true |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
credentialId | string | Yes | |
redirectUris | string[] | Yes |
Output:
| Field | Type | Description |
|---|---|---|
credential | object |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | |
clientId | string | Yes | |
connectorName | string | Yes | |
displayName | string | Yes |
Output:
| Field | Type | Description |
|---|---|---|
credential | object |
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
clientId | string | Yes |
Output:
| Field | Type | Description |
|---|---|---|
found | boolean | |
bound | boolean | |
revoked | boolean |