Core Concepts | Mind Reasoner API Documentation

Mind Reasoner MCP

Mind Reasoner has three core concepts: Minds, Snapshots, and Simulations. Master these, and everything else becomes intuitive.

The basics: Create a Mind → Upload transcripts → Run Simulations

Minds

A mind is a container that represents a person. Think of it as a digital profile.

Overview

Example

API Actions

MCP Tools

What it does

Stores conversation transcripts — Upload and manage training data
Holds metadata — Name, creation date, and configuration
Creates snapshots — Generate multiple AI models over time as data evolves

Minds are the foundation of Mind Reasoner. Each mind represents one person and can have unlimited snapshots trained from different datasets or time periods.

Snapshots

A snapshot is a trained AI model built from conversation transcripts. It captures how someone thinks and communicates at a specific point in time.

How It Works

Requirements

API Actions

MCP Tools

Training process

Upload Data

Provide conversation transcripts (.vtt, .pdf, or .docx). Minimum: 10-20 conversations or 5,000+ words.

AI Training

Mind Reasoner analyzes across hundreds of dimensions of psychometrics. Takes 5-15 minutes.

Ready to Use

Once complete, run unlimited simulations without re-training.

More data = better accuracy. Use recent transcripts (last 6 months) for best results.

Simulations

A simulation predicts how someone would respond to any scenario based on their trained snapshot.

Writing Scenarios

Response Details

API Actions

MCP Tools

How to write effective scenarios

Be Specific

Vague: “How would they handle a complaint?”

Specific: “A customer received a damaged product 3 days before their event. They need a replacement by tomorrow, but the product is out of stock. How would you respond?”