> This page is for version v8.3.0 (default). > For other versions, use one of these documentation indexes: > - v8.3.0 (default): https://docs.workflows.com/v-8-3-0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.workflows.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.workflows.com/_mcp/server. # search_minds READ # search_minds Searches for minds that match specific criteria like name, email, or other attributes. Returns a filtered list of minds with complete details. > **Info** > > Use this tool when you have many minds and need to quickly find specific ones by name, email, or other identifiable attributes. More efficient than retrieving all minds and filtering manually. ## Parameters ### query
**Type** string
**Required** Yes
**Description** Search term to filter minds by name, email, or other attributes
> **Tip** > > The search is case-insensitive and matches partial strings. For example, searching for "sales" will find "Sales Manager", "Top Sales Rep", and "Inside Sales Team". ## Request ```json { "query": "customer service" } ``` ## Response ```json [ { "id": "123e4567-e89b-12d3-a456-426614174000", "name": "Customer Service Manager", "email": "sarah@example.com", "slug": "customer-service-manager", "imageUrl": "https://example.com/avatar.jpg", "socialMedia": { "twitter": "@sarahcsm" }, "scope": "private", "isSelf": false, "tokenCount": 15420, "organizationId": "123e4567-e89b-12d3-a456-426614174001", "createdAt": "2025-01-01T00:00:00.000Z", "updatedAt": "2025-01-15T00:00:00.000Z", "digitalTwins": [ { "id": "123e4567-e89b-12d3-a456-426614174002", "name": "Default Twin", "isDefault": true } ], "mindAssessments": [ { "id": "123e4567-e89b-12d3-a456-426614174003", "status": "completed", "createdAt": "2025-01-10T00:00:00.000Z" } ], "mindCategories": [ { "category": "customer-service" } ] }, { "id": "133e4567-e89b-12d3-a456-426614174000", "name": "Customer Service Team Lead", "email": "team-lead@example.com", "slug": "customer-service-team-lead", "imageUrl": null, "socialMedia": null, "scope": "private", "isSelf": false, "tokenCount": 9200, "organizationId": "123e4567-e89b-12d3-a456-426614174001", "createdAt": "2025-01-03T00:00:00.000Z", "updatedAt": "2025-01-14T00:00:00.000Z", "digitalTwins": [ { "id": "133e4567-e89b-12d3-a456-426614174002", "name": "Default Twin", "isDefault": true } ], "mindAssessments": [ { "id": "133e4567-e89b-12d3-a456-426614174003", "status": "completed", "createdAt": "2025-01-07T00:00:00.000Z" } ], "mindCategories": [ { "category": "customer-service" }, { "category": "management" } ] } ] ``` ### Response Properties Returns an array of mind objects matching the search query. If no matches are found, returns an empty array `[]`. Each mind object contains: | Property | Type | Description | | ----------------- | -------------- | ------------------------------------------------------ | | `id` | string | Unique mind identifier for API calls | | `name` | string | Descriptive name for the mind | | `email` | string \| null | Email address associated with the mind | | `slug` | string | URL-friendly identifier derived from name | | `imageUrl` | string \| null | Avatar or profile image URL | | `socialMedia` | object \| null | Social media handles (twitter, linkedin, etc.) | | `scope` | string | Access level: `private` or `public` | | `isSelf` | boolean | Whether this mind represents the account owner | | `tokenCount` | number \| null | Number of tokens processed from transcripts | | `organizationId` | string | Associated organization identifier | | `createdAt` | string | ISO 8601 timestamp of creation | | `updatedAt` | string | ISO 8601 timestamp of last modification | | `digitalTwins` | array | Digital twin objects (variants for creating snapshots) | | `mindAssessments` | array | Snapshot objects showing training status and history | | `mindCategories` | array | Category labels for organizational purposes | > **Empty Results** > > If no minds match your search query, the tool returns an empty array `[]`. Try broadening your search terms or using `get_all_minds` to see all available minds. ## Common Use Cases #### Find by Name **You:** ``` "Find all minds related to sales" ``` **Mind Reasoner:** Searches for minds with "sales" in the name and returns matching results. #### Find by Email **You:** ``` "Find the mind associated with sarah@example.com" ``` **Mind Reasoner:** Searches by email address and returns the matching mind. #### Filter by Role **You:** ``` "Show me all manager minds" ``` **Mind Reasoner:** Searches for minds with "manager" in the name or attributes. #### Check Before Creating **You:** ``` "Do I already have a mind for Customer Service Manager?" ``` **Mind Reasoner:** Searches before creating a duplicate mind. ## Search Tips #### Name Matching Search by partial name matches: * `"sales"` finds "Sales Manager", "Top Sales Rep" * `"customer"` finds "Customer Service", "Customer Success" * `"manager"` finds "Sales Manager", "Service Manager" #### Email Matching Search by email addresses: * `"sarah@example.com"` finds exact email match * `"@example.com"` finds all minds from that domain * `"sarah"` finds emails starting with sarah #### Best Practices * Use specific terms for fewer results * Use broad terms to explore available minds * Combine with `get_all_minds` to see full catalog * Remember searches are case-insensitive ## Error Responses #### 400 Bad Request ```json { "error": "Bad Request", "message": "Query parameter is required" } ``` **Solution:** Ensure you provide a non-empty query string. #### 401 Unauthorized ```json { "error": "Unauthorized", "message": "Invalid or missing API key" } ``` **Solution:** Verify your API key in the MCP server configuration. #### 429 Rate Limit Exceeded ```json { "error": "Too Many Requests", "message": "Rate limit exceeded. Retry after 60 seconds", "retryAfter": 60 } ``` **Solution:** Wait before making additional requests. ## Next Steps #### [List All Minds](/mcp-tool-get-all-minds) View complete catalog of minds #### [Run Simulations](/mcp-tool-simulate) Use a mind ID to run simulations ## See Also #### [Tools Reference](/mcp-tools) View all available MCP tools