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

# Preview Connector Tools

> The tools the server currently exposes, without importing anything. Use it to show a picker before scoping a PAL down with `layers.mcp.connector_tools`.



## OpenAPI

````yaml get /v2/connectors/{connector_id}/preview
openapi: 3.0.3
info:
  title: Tavus Developer API Collection
  version: 1.0.0
  contact: {}
servers:
  - url: https://tavusapi.com
security:
  - apiKey: []
tags:
  - name: Videos
  - name: Faces
  - name: Voices
  - name: Conversations
  - name: Deployments
  - name: PALs
  - name: Tools
  - name: PAL Tools
  - name: Connectors
  - name: Pronunciation Dictionaries
  - name: Replacements
  - name: Transcriptions
  - name: Documents
  - name: Memory Stores
paths:
  /v2/connectors/{connector_id}/preview:
    parameters:
      - name: connector_id
        in: path
        required: true
        schema:
          type: string
          example: c8-58ea0f6420b2
    get:
      tags:
        - Connectors
      summary: Preview Connector Tools
      description: >-
        The tools the server currently exposes, without importing anything. Use
        it to show a picker before scoping a PAL down with
        `layers.mcp.connector_tools`.
      operationId: previewConnector
      responses:
        '200':
          description: Tool list returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  tools:
                    type: array
                    description: >-
                      The server's own `tools/list` response, untouched. Each
                      entry's `name` is what you list in a PAL's
                      `layers.mcp.connector_tools` to scope that connector down.
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: The tool name, as the server reports it.
                          example: search_messages
                        description:
                          type: string
                          description: The server's description of the tool.
                          example: Search messages across channels.
                        inputSchema:
                          type: object
                          description: >-
                            JSON Schema for the tool's arguments, as the server
                            reports it.
                    example:
                      - name: search_messages
                        description: Search messages across channels.
                        inputSchema:
                          type: object
                          properties:
                            query:
                              type: string
                      - name: post_message
                        description: Post a message to a channel.
                  selected_tool_names:
                    type: array
                    nullable: true
                    deprecated: true
                    description: >-
                      Always `null` on connectors created today. A
                      connector-level selection left over from the removed tool
                      importer; tool scoping is a per-PAL decision, so use
                      `layers.mcp.connector_tools`.
                    items:
                      type: string
        '409':
          description: OAuth is not finished for this connector
        '502':
          description: The MCP server could not be reached, or returned an error
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````