READ

get_all_minds

Retrieves a list of all minds associated with your account. Returns complete details including digital twins, categories, snapshots, and metadata.

Use this tool to view all minds you’ve created, check their status, and get IDs for running simulations. Perfect for auditing, management, or selecting which mind to work with.

Parameters

This tool takes no parameters. It returns all minds for the authenticated account.

Request

1 {}

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       "linkedin": "sarah-manager"
11     },
12     "scope": "private",
13     "isSelf": false,
14     "tokenCount": 15420,
15     "organizationId": "123e4567-e89b-12d3-a456-426614174001",
16     "createdAt": "2025-01-01T00:00:00.000Z",
17     "updatedAt": "2025-01-15T00:00:00.000Z",
18     "digitalTwins": [
19       {
20         "id": "123e4567-e89b-12d3-a456-426614174002",
21         "name": "Default Twin",
22         "isDefault": true
23       }
24     ],
25     "mindAssessments": [
26       {
27         "id": "123e4567-e89b-12d3-a456-426614174003",
28         "status": "completed",
29         "createdAt": "2025-01-10T00:00:00.000Z"
30       }
31     ],
32     "mindCategories": [
33       {
34         "category": "customer-service"
35       }
36     ]
37   },
38   {
39     "id": "223e4567-e89b-12d3-a456-426614174000",
40     "name": "Sales Executive Mike",
41     "email": null,
42     "slug": "sales-executive-mike",
43     "imageUrl": null,
44     "socialMedia": null,
45     "scope": "private",
46     "isSelf": false,
47     "tokenCount": 8750,
48     "organizationId": "123e4567-e89b-12d3-a456-426614174001",
49     "createdAt": "2025-01-05T00:00:00.000Z",
50     "updatedAt": "2025-01-12T00:00:00.000Z",
51     "digitalTwins": [
52       {
53         "id": "223e4567-e89b-12d3-a456-426614174002",
54         "name": "Default Twin",
55         "isDefault": true
56       }
57     ],
58     "mindAssessments": [
59       {
60         "id": "223e4567-e89b-12d3-a456-426614174003",
61         "status": "completed",
62         "createdAt": "2025-01-08T00:00:00.000Z"
63       }
64     ],
65     "mindCategories": []
66   }
67 ]

Response Properties

Returns an array of mind objects. 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

Finding Mind IDs: Use this tool to retrieve mind IDs when you need to run simulations or manage existing minds. Your AI assistant can filter results based on name or characteristics.

Common Use Cases

List All Available Minds

You:

"Show me all the minds I've created"

Mind Reasoner: Calls get_all_minds and presents a formatted list with names, IDs, and snapshot status.

Check Snapshot Status

You:

"Which of my minds have completed snapshots and are ready for simulations?"

Mind Reasoner: Filters the results to show only minds with completed training.

Find Mind ID

You:

"What's the ID for my Sales Executive Mike mind?"

Mind Reasoner: Searches the results and returns the specific mind ID.

Error Responses

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

Search Minds

Filter minds by specific criteria

Run Simulations

Use a mind ID to run simulations

get_all_minds

Parameters

Request

Response

Response Properties

Common Use Cases

List All Available Minds

Check Snapshot Status

Find Mind ID

Error Responses

401 Unauthorized

429 Rate Limit Exceeded

Next Steps

See Also