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.

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

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

1 {
2   "query": "customer service"
3 }

Response

1 [
2   {
3     "id": "123e4567-e89b-12d3-a456-426614174000",
4     "name": "Customer Service Manager",
5     "email": "sarah@example.com",
6     "slug": "customer-service-manager",
7     "imageUrl": "https://example.com/avatar.jpg",
8     "socialMedia": {
9       "twitter": "@sarahcsm"
10     },
11     "scope": "private",
12     "isSelf": false,
13     "tokenCount": 15420,
14     "organizationId": "123e4567-e89b-12d3-a456-426614174001",
15     "createdAt": "2025-01-01T00:00:00.000Z",
16     "updatedAt": "2025-01-15T00:00:00.000Z",
17     "digitalTwins": [
18       {
19         "id": "123e4567-e89b-12d3-a456-426614174002",
20         "name": "Default Twin",
21         "isDefault": true
22       }
23     ],
24     "mindAssessments": [
25       {
26         "id": "123e4567-e89b-12d3-a456-426614174003",
27         "status": "completed",
28         "createdAt": "2025-01-10T00:00:00.000Z"
29       }
30     ],
31     "mindCategories": [
32       {
33         "category": "customer-service"
34       }
35     ]
36   },
37   {
38     "id": "133e4567-e89b-12d3-a456-426614174000",
39     "name": "Customer Service Team Lead",
40     "email": "team-lead@example.com",
41     "slug": "customer-service-team-lead",
42     "imageUrl": null,
43     "socialMedia": null,
44     "scope": "private",
45     "isSelf": false,
46     "tokenCount": 9200,
47     "organizationId": "123e4567-e89b-12d3-a456-426614174001",
48     "createdAt": "2025-01-03T00:00:00.000Z",
49     "updatedAt": "2025-01-14T00:00:00.000Z",
50     "digitalTwins": [
51       {
52         "id": "133e4567-e89b-12d3-a456-426614174002",
53         "name": "Default Twin",
54         "isDefault": true
55       }
56     ],
57     "mindAssessments": [
58       {
59         "id": "133e4567-e89b-12d3-a456-426614174003",
60         "status": "completed",
61         "createdAt": "2025-01-07T00:00:00.000Z"
62       }
63     ],
64     "mindCategories": [
65       {
66         "category": "customer-service"
67       },
68       {
69         "category": "management"
70       }
71     ]
72   }
73 ]

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

Email Matching

Best Practices

Search by partial name matches:

"sales" finds “Sales Manager”, “Top Sales Rep”
"customer" finds “Customer Service”, “Customer Success”
"manager" finds “Sales Manager”, “Service Manager”

Error Responses

400 Bad Request

1 {
2   "error": "Bad Request",
3   "message": "Query parameter is required"
4 }

Solution: Ensure you provide a non-empty query string.

401 Unauthorized

1 {
2   "error": "Unauthorized",
3   "message": "Invalid or missing API key"
4 }

Solution: Verify your API key in the MCP server configuration.

429 Rate Limit Exceeded

1 {
2   "error": "Too Many Requests",
3   "message": "Rate limit exceeded. Retry after 60 seconds",
4   "retryAfter": 60
5 }

Solution: Wait before making additional requests.

Next Steps

List All Minds

View complete catalog of minds

Run Simulations

Use a mind ID to run simulations

search_minds

Parameters

query

Request

Response

Response Properties

Empty Results

Common Use Cases

Find by Name

Find by Email

Filter by Role

Check Before Creating

Search Tips

Name Matching

Email Matching

Best Practices

Error Responses

400 Bad Request

401 Unauthorized

429 Rate Limit Exceeded

Next Steps

See Also