> 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.

# get_all_minds

READ

# get_all_minds

Retrieves a list of all

minds

associated with your account. Returns complete details including digital twins, categories, snapshots, and metadata.

> **Info**
>
> 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

```json
{}
```

## 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",
      "linkedin": "sarah-manager"
    },
    "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": "223e4567-e89b-12d3-a456-426614174000",
    "name": "Sales Executive Mike",
    "email": null,
    "slug": "sales-executive-mike",
    "imageUrl": null,
    "socialMedia": null,
    "scope": "private",
    "isSelf": false,
    "tokenCount": 8750,
    "organizationId": "123e4567-e89b-12d3-a456-426614174001",
    "createdAt": "2025-01-05T00:00:00.000Z",
    "updatedAt": "2025-01-12T00:00:00.000Z",
    "digitalTwins": [
      {
        "id": "223e4567-e89b-12d3-a456-426614174002",
        "name": "Default Twin",
        "isDefault": true
      }
    ],
    "mindAssessments": [
      {
        "id": "223e4567-e89b-12d3-a456-426614174003",
        "status": "completed",
        "createdAt": "2025-01-08T00:00:00.000Z"
      }
    ],
    "mindCategories": []
  }
]
```

### 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            |

> **Tip**
>
> **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

```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

#### [Search Minds](/mcp-tool-search-minds)

Filter minds by specific criteria

#### [Run Simulations](/mcp-tool-simulate)

Use a mind ID to run simulations

## See Also

#### [Tools Reference](/mcp-tools)

View all available MCP tools