For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • Workflows
    • Overview
  • Get Started
    • MCP Quick Start
    • API Quick Start
  • MCP Server
    • Overview
    • Installation
      • Overview
      • get_all_minds
      • search_minds
      • create_mind
      • get_signed_upload_url
      • upload_file_to_signed_url
      • create_snapshot
      • get_snapshot_status
      • simulate
      • gong_list_calls
      • gong_get_transcript
      • gong_get_call_details
      • fathom_list_meetings
      • fathom_get_transcript
      • fathom_get_meeting_details
      • fireflies_list_transcripts
      • fireflies_get_transcript
      • fireflies_search_transcripts
  • Direct API
    • Overview
    • Authentication
    • Error Handling
  • Core Concepts
    • Minds, Snapshots, & Simulations
    • SOC 2, HIPAA, & GDPR
LogoLogo
LogoLogo
On this page
  • Parameters
  • Request
  • Response
  • Response Properties
  • Common Use Cases
  • Error Responses
  • Next Steps
  • See Also
MCP ServerTools Reference

get_all_minds

List all minds in your account
Was this page helpful?
Previous

search_minds

Search for minds by name, email, or attributes
Next
Built with
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:

PropertyTypeDescription
idstringUnique mind identifier for API calls
namestringDescriptive name for the mind
emailstring | nullEmail address associated with the mind
slugstringURL-friendly identifier derived from name
imageUrlstring | nullAvatar or profile image URL
socialMediaobject | nullSocial media handles (twitter, linkedin, etc.)
scopestringAccess level: private or public
isSelfbooleanWhether this mind represents the account owner
tokenCountnumber | nullNumber of tokens processed from transcripts
organizationIdstringAssociated organization identifier
createdAtstringISO 8601 timestamp of creation
updatedAtstringISO 8601 timestamp of last modification
digitalTwinsarrayDigital twin objects (variants for creating snapshots)
mindAssessmentsarraySnapshot objects showing training status and history
mindCategoriesarrayCategory 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

See Also

Tools Reference

View all available MCP tools