> ## 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. # Search > Search returns a connector's MCP tools filtered by state, classification, visibility, access-profile binding, or text query. Filter on MCP_TOOL_STATE_PENDING_REVIEW to find tools awaiting approval, then approve them with Update. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/apps/{app_id}/connectors/{connector_id}/mcp_tools/search 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/search: post: tags: - MCP Tools summary: Search description: >- Search returns a connector's MCP tools filtered by state, classification, visibility, access-profile binding, or text query. Filter on MCP_TOOL_STATE_PENDING_REVIEW to find tools awaiting approval, then approve them with Update. operationId: c1.api.ai_governance.v1.MCPToolService.Search 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 requestBody: content: application/json: schema: $ref: >- #/components/schemas/c1.api.ai_governance.v1.MCPToolServiceSearchRequestInput responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.ai_governance.v1.MCPToolServiceSearchResponse description: MCPToolServiceSearchResponse returns matching MCP tools. x-codeSamples: - lang: typescript label: Typescript (SDK) source: >- import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript"; const conductoroneSDKTypescript = new ConductoroneSDKTypescript({ security: { bearerAuth: "", oauth: "", }, }); async function run() { const result = await conductoroneSDKTypescript.mcpTool.search({ appId: "", connectorId: "", }); console.log(result); } run(); components: schemas: c1.api.ai_governance.v1.MCPToolServiceSearchRequestInput: description: MCPToolServiceSearchRequest searches MCP tools with filters. properties: accessProfileId: deprecated: true description: 'Deprecated: use access_profile_ids instead.' type: - string - 'null' accessProfileIds: description: >- Optional: only return tools that are bound to at least one of these access profiles. items: type: string type: - array - 'null' classificationFilter: description: Optional filter by classification. 0 (UNSPECIFIED) means no filter. items: enum: - TOOL_CLASSIFICATION_UNSPECIFIED - TOOL_CLASSIFICATION_READ - TOOL_CLASSIFICATION_WRITE - TOOL_CLASSIFICATION_DESTRUCTIVE - TOOL_CLASSIFICATION_SENSITIVE - TOOL_CLASSIFICATION_DANGEROUS type: string x-speakeasy-unknown-values: allow type: - array - 'null' excludeAccessProfileId: deprecated: true description: 'Deprecated: use exclude_access_profile_ids instead.' type: - string - 'null' excludeAccessProfileIds: description: >- Optional: exclude tools that are bound to any of these access profiles. items: type: string type: - array - 'null' includeLastCalledAt: description: |- When true, the server populates MCPTool.last_called_at on each returned row by querying TSDB for the most recent `mcp_tool_calls` raw emit time per tool. Costs one Dynamo Limit(1) read per row; callers that don't render the "Last used" column should leave false. type: - boolean - 'null' pageSize: description: Page size (max 100). format: int32 type: - integer - 'null' pageToken: description: Page token for pagination. type: - string - 'null' query: description: Optional text query matched against tool_name and display_name type: - string - 'null' refs: description: >- Optional: filter by specific tool refs (used by websocket notify to re-fetch individual tools). items: $ref: '#/components/schemas/c1.api.ai_governance.v1.MCPToolRef' type: - array - 'null' stateFilter: description: Optional filter by tool state. 0 (UNSPECIFIED) means no filter. items: enum: - MCP_TOOL_STATE_UNSPECIFIED - MCP_TOOL_STATE_PENDING_REVIEW - MCP_TOOL_STATE_APPROVED - MCP_TOOL_STATE_DISABLED - MCP_TOOL_STATE_REMOVED type: string x-speakeasy-unknown-values: allow type: - array - 'null' visibilityFilter: description: Optional filter by visibility. 0 (UNSPECIFIED) means no filter. items: enum: - TOOL_VISIBILITY_UNSPECIFIED - TOOL_VISIBILITY_FEATURED - TOOL_VISIBILITY_AVAILABLE - TOOL_VISIBILITY_BYPASSED type: string x-speakeasy-unknown-values: allow type: - array - 'null' title: Mcp Tool Service Search Request type: object x-speakeasy-name-override: MCPToolServiceSearchRequest c1.api.ai_governance.v1.MCPToolServiceSearchResponse: description: MCPToolServiceSearchResponse returns matching MCP tools. properties: list: description: Matching MCP tools. items: $ref: '#/components/schemas/c1.api.ai_governance.v1.MCPTool' type: - array - 'null' nextPageToken: description: Token for next page. type: - string - 'null' title: Mcp Tool Service Search Response type: object x-speakeasy-name-override: MCPToolServiceSearchResponse c1.api.ai_governance.v1.MCPToolRef: description: MCPToolRef is a reference to a specific MCP tool. properties: appId: description: The appId field. type: - string - 'null' connectorId: description: The connectorId field. type: - string - 'null' id: description: The id field. type: - string - 'null' title: Mcp Tool Ref type: object x-speakeasy-name-override: MCPToolRef 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 ````