> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-mcp-bridge-private-server.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List

> List returns the MCP tools discovered for a single (app_id, connector_id),
 paginated. To filter by state, classification, or visibility, use Search.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/connectors/{connector_id}/mcp_tools
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/apps/{app_id}/connectors/{connector_id}/mcp_tools:
    get:
      tags:
        - MCP Tools
      summary: List
      description: >-
        List returns the MCP tools discovered for a single (app_id,
        connector_id),
         paginated. To filter by state, classification, or visibility, use Search.
      operationId: c1.api.ai_governance.v1.MCPToolService.List
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: App identifier (required).
            type: string
        - in: path
          name: connector_id
          required: true
          schema:
            description: Connector ID (required).
            type: string
        - in: query
          name: page_size
          schema:
            description: Page size (max 100).
            format: int32
            type: integer
        - in: query
          name: page_token
          schema:
            description: Page token for pagination.
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.ai_governance.v1.MCPToolServiceListResponse
          description: MCPToolServiceListResponse returns a list of MCP tools.
      x-codeSamples:
        - lang: typescript
          label: Typescript (SDK)
          source: >-
            import { ConductoroneSDKTypescript } from
            "conductorone-sdk-typescript";


            const conductoroneSDKTypescript = new ConductoroneSDKTypescript({
              security: {
                bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
                oauth: "<YOUR_OAUTH_HERE>",
              },
            });


            async function run() {
              const result = await conductoroneSDKTypescript.mcpTool.list({
                appId: "<id>",
                connectorId: "<id>",
              });

              console.log(result);
            }


            run();
components:
  schemas:
    c1.api.ai_governance.v1.MCPToolServiceListResponse:
      description: MCPToolServiceListResponse returns a list of MCP tools.
      properties:
        nextPageToken:
          description: Token for next page.
          type:
            - string
            - 'null'
        tools:
          description: List of MCP tools.
          items:
            $ref: '#/components/schemas/c1.api.ai_governance.v1.MCPTool'
          type:
            - array
            - 'null'
      title: Mcp Tool Service List Response
      type: object
      x-speakeasy-name-override: MCPToolServiceListResponse
    c1.api.ai_governance.v1.MCPTool:
      description: >-
        MCPTool represents metadata about individual tools discovered from an
        MCP server.
      properties:
        allowedClientTypes:
          description: |-
            Which client types may use this tool.
             Empty = all allowed types from tenant config.
          items:
            enum:
              - MCP_CLIENT_TYPE_UNSPECIFIED
              - MCP_CLIENT_TYPE_PERSONAL
              - MCP_CLIENT_TYPE_SHARED
              - MCP_CLIENT_TYPE_SERVICE
              - MCP_CLIENT_TYPE_EPHEMERAL
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
        appEntitlementId:
          description: Bound AppEntitlement created during sync.
          type:
            - string
            - 'null'
        appId:
          description: App identifier (app that owns the connector).
          type:
            - string
            - 'null'
        classification:
          description: Tool risk classification for policy decisions.
          enum:
            - TOOL_CLASSIFICATION_UNSPECIFIED
            - TOOL_CLASSIFICATION_READ
            - TOOL_CLASSIFICATION_WRITE
            - TOOL_CLASSIFICATION_DESTRUCTIVE
            - TOOL_CLASSIFICATION_SENSITIVE
            - TOOL_CLASSIFICATION_DANGEROUS
          type:
            - string
            - 'null'
          x-speakeasy-unknown-values: allow
        connectorId:
          description: Connector identifier.
          type:
            - string
            - 'null'
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        defaultClassification:
          description: >-
            Default tool classification from MCP config (system-managed during
            discovery).
          enum:
            - TOOL_CLASSIFICATION_UNSPECIFIED
            - TOOL_CLASSIFICATION_READ
            - TOOL_CLASSIFICATION_WRITE
            - TOOL_CLASSIFICATION_DESTRUCTIVE
            - TOOL_CLASSIFICATION_SENSITIVE
            - TOOL_CLASSIFICATION_DANGEROUS
          type:
            - string
            - 'null'
          x-speakeasy-unknown-values: allow
        defaultDisplayName:
          description: Default display name from MCP tool spec (title field).
          type:
            - string
            - 'null'
        defaultVisibility:
          description: >-
            System-managed default visibility from MCP config (set during
            discovery).
          enum:
            - TOOL_VISIBILITY_UNSPECIFIED
            - TOOL_VISIBILITY_FEATURED
            - TOOL_VISIBILITY_AVAILABLE
            - TOOL_VISIBILITY_BYPASSED
          type:
            - string
            - 'null'
          x-speakeasy-unknown-values: allow
        deletedAt:
          format: date-time
          type:
            - string
            - 'null'
        description:
          description: Admin-editable description.
          type:
            - string
            - 'null'
        discoveryHash:
          description: Hash of tool definition for change detection.
          type:
            - string
            - 'null'
        displayName:
          description: >-
            Admin-editable display name (overrides default_display_name when
            set).
          type:
            - string
            - 'null'
        id:
          description: Unique identifier for this MCP tool record.
          type:
            - string
            - 'null'
        inputSchemaJson:
          description: JSON-encoded input schema from MCP discovery.
          type:
            - string
            - 'null'
        lastCalledAt:
          format: date-time
          readOnly: true
          type:
            - string
            - 'null'
        state:
          description: Tool approval/lifecycle state.
          enum:
            - MCP_TOOL_STATE_UNSPECIFIED
            - MCP_TOOL_STATE_PENDING_REVIEW
            - MCP_TOOL_STATE_APPROVED
            - MCP_TOOL_STATE_DISABLED
            - MCP_TOOL_STATE_REMOVED
          type:
            - string
            - 'null'
          x-speakeasy-unknown-values: allow
        toolName:
          description: Native MCP tool name (unique within an MCP server).
          type:
            - string
            - 'null'
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
        visibility:
          description: >-
            Admin-settable visibility override (how this tool is surfaced to
            users).
          enum:
            - TOOL_VISIBILITY_UNSPECIFIED
            - TOOL_VISIBILITY_FEATURED
            - TOOL_VISIBILITY_AVAILABLE
            - TOOL_VISIBILITY_BYPASSED
          type:
            - string
            - 'null'
          x-speakeasy-unknown-values: allow
      title: Mcp Tool
      type: object
      x-speakeasy-name-override: MCPTool
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````