List of supported psychometric tools

SotsAI requires a user psychometric profile to generate behavioral reasoning.

This page lists:

• the supported tool identifiers (as per today)
• the expected raw_scores shapes
• copy-pastable examples you can use in /v1/advice

---

Core rule

user_profile.tool selects the psychometric framework, and user_profile.raw_scores carries the framework-specific data.

Note

SotsAI never infers profiles from text.
If you don’t have a valid user_profile, do not call /v1/advice.

---

Supported tools

Tool	Identifier	Status
DISC	disc	supported
MBTI	mbti	supported
Insights Discovery	insights	supported

---

Canonical profile shape

All tools follow the same outer structure:

{
  "tool": "...", <-- tool identifier
  "raw_scores": { }
}

You’ll place this under user_profile (and optionally interlocutor_profile) in /v1/advice.

---

Tool Payload

DISC ('disc')

What SotsAI expects raw_scores

natural required

• Set of D, I, S & C scores (0-100).

adapted required

• Set of D, I, S & C scores (0-100).

Single-profile DISC variants

If you use a DISC variant that provides only one set of D/I/S/C scores (for example, Everything DiSC), use the same scores for both the natural and adapted fields.

Minimal profile example copy/paste

{
  "tool": "disc",
  "raw_scores": {
    "natural": { "D": 78, "I": 64, "S": 22, "C": 36 },
    "adapted": { "D": 70, "I": 58, "S": 30, "C": 42 }
  }
}

Using it in /v1/advice

{
  "context_summary": "The user needs to give corrective feedback to a direct report who keeps missing deadlines. The user wants to be firm without demotivating them.",
  "relationship_type": "direct_report",
  "user_profile": {
    "tool": "disc",
    "raw_scores": {
      "natural": { "D": 78, "I": 64, "S": 22, "C": 36 },
      "adapted": { "D": 70, "I": 58, "S": 30, "C": 42 }
    }
  }
}

MBTI ('mbti')

What SotsAI expects raw_scores

MBTI supports a compact type code (one of the 16 MBTI official types).

type required (e.g. INFJ, ESTP…)

Minimal profile example copy/paste

{
  "tool": "mbti",
  "raw_scores": {
    "type": "INTJ"
  }
}

Tip

Keep MBTI inputs factual: provide the known type. Do not ask the model to guess MBTI from conversation text.

Insights ('insights')

What SotsAI expects raw_scores

• fiery_red required: score (0-100)
• sunshine_yellow required: score (0-100)
• earth_green required: score (0-100)
• cool_blue required: score (0-100)

Note

If your provider uses another scale (e.g. 0–10, 0–30, percentages), you must convert before calling the API.

Minimal profile example copy/paste

{
  "tool": "insights",
  "raw_scores": {
    "fiery_red": 70,
    "sunshine_yellow": 55,
    "earth_green": 35,
    "cool_blue": 40
  }
}

Notes on normalization

If your source tool uses percentiles, preferences, or a different scale, normalize to 0–100. Exact scoring methodology doesn’t need to match another vendor; consistency within your org matters most.

---

Validation and safety rules

Do / Don’t

Do:

• ✅ pass known psychometric data from your systems or SotsAI-managed assessments
• ✅ normalize numeric scores to 0–100 when applicable
• ✅ keep profiles stable across calls (cache them)

Don’t:

• ❌ have the LLM infer or fabricate profiles
• ❌ embed personal identifiers in profiles