> ## Documentation Index > Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt > Use this file to discover all available pages before exploring further. # Search Tools > Fuzzy search the unified tool catalog by name or description. ## OpenAPI ````yaml GET /v1/tools/search openapi: 3.1.0 info: title: xpander.ai API Service description: |2- The xpander.ai API Service provides a unified REST API for managing AI agents, executing tasks, managing knowledge bases, and integrating with external systems. Features: - Agent Management: Create, update, deploy, and delete AI agents - Task Execution: Invoke agents with support for sync, async, and streaming modes - Knowledge Bases: Manage knowledge bases and documents for RAG workflows - Tools: Discover, connect, and attach tools (connectors, custom functions, MCP servers, sub-agents, workflows) to agents and workflows - MCP Integration: Model Context Protocol support for standardized AI interactions Authentication: All endpoints require authentication via either an API key (`x-api-key`) or an OAuth2 JWT (`Authorization: Bearer `). version: '0.001' servers: - url: https://api.xpander.ai security: [] paths: /v1/tools/search: get: tags: - API v1 - Tools - Tools Discovery summary: Search Tools description: Fuzzy search the unified tool catalog by name/description. operationId: Search_tools_v1_tools_search_get parameters: - name: query in: query required: true schema: type: string description: Search query. title: Query description: Search query. - name: type in: query required: false schema: anyOf: - $ref: '#/components/schemas/ToolKind' - type: 'null' description: Filter by tool kind. title: Type description: Filter by tool kind. responses: '200': description: Successful Response content: application/json: schema: type: array items: $ref: '#/components/schemas/ToolCatalogItem' title: Response Search Tools V1 Tools Search Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: ToolKind: type: string enum: - connector - agent - workflow - custom_function - mcp title: ToolKind description: Kind of attachable tool in the unified catalog. ToolCatalogItem: properties: kind: $ref: '#/components/schemas/ToolKind' description: What kind of tool this is. id: type: string title: Id description: >- Identifier to attach this tool: connector_id, agent_id, workflow_id, custom_function_id, or mcp registry id. name: type: string title: Name description: Display name. description: anyOf: - type: string - type: 'null' title: Description description: What the tool does. logo: anyOf: - type: string - type: 'null' title: Logo description: Logo/icon identifier. status: anyOf: - type: string - type: 'null' title: Status description: Connector status ('ready' means usable). Connectors only. total_operations: anyOf: - type: integer - type: 'null' title: Total Operations description: Number of operations available. Connectors only. using_built_in_auth: anyOf: - type: boolean - type: 'null' title: Using Built In Auth description: Whether xpander manages auth for this connector. connections: anyOf: - items: $ref: '#/components/schemas/ConnectionSummary' type: array - type: 'null' title: Connections description: >- Existing connections for this connector in your org. Connectors only. transport: anyOf: - type: string - type: 'null' title: Transport description: MCP transport. MCP only. auth_type: anyOf: - type: string - type: 'null' title: Auth Type description: MCP auth type. MCP only. url: anyOf: - type: string - type: 'null' title: Url description: MCP server URL. MCP only. type: object required: - kind - id - name title: ToolCatalogItem description: >- A discoverable, attachable tool returned by GET /tools and /tools/search. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ConnectionSummary: properties: id: type: string title: Id description: >- Unique identifier of this connection. Use this ID when referencing the connection in operations or agent tool configuration. name: type: string title: Name description: >- Human-readable name for this connection instance (e.g., 'Production Slack', 'Dev Jira'). access_scope: anyOf: - type: string - type: 'null' title: Access Scope description: >- Who can use this connection. 'organizational' is visible to all org members. 'personal' is only visible to the connection owner. is_service_account: anyOf: - type: boolean - type: 'null' title: Is Service Account description: >- Whether this connection uses a service account (shared org-level credentials) rather than personal user credentials. default: false owner: anyOf: - type: string - type: 'null' title: Owner description: >- User ID of the connection owner. Only relevant for personal connections. version: anyOf: - type: string - type: 'null' title: Version description: >- The connector version this connection is pinned to. May differ from the connector's latest version. open_api_spec_id: anyOf: - type: string - type: 'null' title: Open Api Spec Id description: >- OpenAPI spec ID this connection uses. May differ from the connector's default spec if the connection is pinned to a specific version. created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At description: Optional creation date of the connection. type: object required: - id - name title: ConnectionSummary description: |- Lightweight summary of a connector connection (org↔connector binding). Returned as part of ConnectorItem.connections when listing connectors. Each connection represents a configured instance of a connector within an organization, with its own authentication and settings. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey description: API Key for authentication in: header name: x-api-key ````