> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List MCP Connections

> Connections to external systems that AI agents can call tools against.

A connection is created as a draft pinned to the connector's current version. Fill its
credentials directly with ``config``, or mint a setup link and let a third party fill
them in their own browser; then ``PATCH {"active": true}`` to put it in service. Each
connector may hold several connections, one per account you connect, each with its own
slug — which is also the namespace its tools are exposed under.

On plans with access control, visibility and writes follow the access granted on each
connection: viewers see it, editors edit its description and tags, managers change
everything else — configuration, state, slug, the exposed tools, setup links and
disconnection. Admins and owners always have full access.



## OpenAPI

````yaml GET /api/v1/live-connections/
openapi: 3.0.3
info:
  title: Nekt API
  version: v1
  description: Nekt API Documentation
  contact:
    email: support@nekt.ai
servers:
  - url: https://api.nekt.ai
security: []
paths:
  /api/v1/live-connections/:
    get:
      tags:
        - v1
      description: >-
        Connections to external systems that AI agents can call tools against.


        A connection is created as a draft pinned to the connector's current
        version. Fill its

        credentials directly with ``config``, or mint a setup link and let a
        third party fill

        them in their own browser; then ``PATCH {"active": true}`` to put it in
        service. Each

        connector may hold several connections, one per account you connect,
        each with its own

        slug — which is also the namespace its tools are exposed under.


        On plans with access control, visibility and writes follow the access
        granted on each

        connection: viewers see it, editors edit its description and tags,
        managers change

        everything else — configuration, state, slug, the exposed tools, setup
        links and

        disconnection. Admins and owners always have full access.
      operationId: v1_live_connections_list
      parameters:
        - in: query
          name: active
          schema:
            type: boolean
        - in: query
          name: archived
          schema:
            type: boolean
        - in: query
          name: connector_slug
          schema:
            type: string
        - in: query
          name: created_at__gt
          schema:
            type: string
            format: date-time
        - in: query
          name: created_at__gte
          schema:
            type: string
            format: date-time
        - in: query
          name: created_at__lt
          schema:
            type: string
            format: date-time
        - in: query
          name: created_at__lte
          schema:
            type: string
            format: date-time
        - in: query
          name: created_by
          schema:
            type: integer
        - in: query
          name: draft
          schema:
            type: boolean
        - in: query
          name: error
          schema:
            type: boolean
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - name: search
          required: false
          in: query
          description: A search term.
          schema:
            type: string
        - in: query
          name: slug
          schema:
            type: string
        - in: query
          name: sort
          schema:
            type: array
            items:
              type: string
              enum:
                - '-active'
                - '-connector_slug'
                - '-created_at'
                - '-created_by'
                - '-description'
                - '-slug'
                - '-updated_at'
                - active
                - connector_slug
                - created_at
                - created_by
                - description
                - slug
                - updated_at
          description: |-
            Ordering

            * `slug` - Slug
            * `-slug` - Slug (descending)
            * `connector_slug` - Connector slug
            * `-connector_slug` - Connector slug (descending)
            * `description` - Description
            * `-description` - Description (descending)
            * `created_by` - Created by
            * `-created_by` - Created by (descending)
            * `active` - Active
            * `-active` - Active (descending)
            * `created_at` - Created at
            * `-created_at` - Created at (descending)
            * `updated_at` - Updated at
            * `-updated_at` - Updated at (descending)
          explode: false
          style: form
        - in: query
          name: tag
          schema:
            type: string
        - in: query
          name: updated_at__gt
          schema:
            type: string
            format: date-time
        - in: query
          name: updated_at__gte
          schema:
            type: string
            format: date-time
        - in: query
          name: updated_at__lt
          schema:
            type: string
            format: date-time
        - in: query
          name: updated_at__lte
          schema:
            type: string
            format: date-time
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedLiveConnectionList'
          description: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    PaginatedLiveConnectionList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/LiveConnection'
    LiveConnection:
      type: object
      description: >-
        A connection to an external system that AI agents can call tools
        against.
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        connector:
          type: string
          description: Connector of this connection (Expandable)
        connector_version:
          type: string
          format: uuid
          readOnly: true
        connector_config:
          type: object
          additionalProperties: {}
          readOnly: true
        config:
          writeOnly: true
        callback_webhook:
          allOf:
            - $ref: '#/components/schemas/LiveConnectionCallbackWebhook'
          writeOnly: true
          nullable: true
        has_callback_webhook:
          type: boolean
          readOnly: true
        credentials_version:
          type: integer
          readOnly: true
          description: >-
            Bumped whenever connector_config changes (in the viewset/serializer,
            not a signal); the MCP uses it to invalidate its credential cache
        active:
          type: boolean
          description: The user on/off toggle. Activating clears draft and error.
        draft:
          type: boolean
          readOnly: true
          description: >-
            Not yet activated for the first time; the setup-link flow is only
            valid while draft (or error).
        error:
          type: boolean
          readOnly: true
          description: >-
            Set by the credential broker on a refused OAuth refresh; the
            connection needs a reconnect and is not served while set.
        archived:
          type: boolean
          readOnly: true
          description: >-
            Set via the archive/unarchive endpoints (mirrors Pipeline.archived);
            archived connections are never served to the MCP server.
        slug:
          type: string
          description: >-
            Stable identifier and tool namespace; globally unique. Defaults to
            the connector slug (uniquified) when left blank.
          maxLength: 256
          pattern: ^[-a-zA-Z0-9_]+$
        description:
          type: string
          nullable: true
        available_tools:
          type: array
          items:
            type: string
        tags:
          type: array
          items: {}
          readOnly: true
        permission_level:
          type: string
          readOnly: true
          nullable: true
        created_by:
          type: object
          additionalProperties: {}
          readOnly: true
        created_at:
          type: string
          format: date-time
          readOnly: true
        updated_at:
          type: string
          format: date-time
          readOnly: true
      required:
        - archived
        - connector
        - connector_config
        - connector_version
        - created_at
        - created_by
        - credentials_version
        - draft
        - error
        - has_callback_webhook
        - id
        - permission_level
        - tags
        - updated_at
    LiveConnectionCallbackWebhook:
      type: object
      description: >-
        Where Nekt announces that someone finished configuring this connection
        through a setup link.
      properties:
        url:
          type: string
          format: uri
          maxLength: 2048
        header_name:
          type: string
          maxLength: 256
        header_value:
          type: string
          writeOnly: true
          maxLength: 2048
      required:
        - url
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: 'API Key authentication. Format: ''x-api-key: api_key'''

````