← Back to Docs

MCP Tools

MCP Tools Reference

get_human_state

Returns the current unified state for a session.

Parameters:

  • session_id (string, required) — The session identifier

Returns: stress score (0-100), state label, active signals, confidence, a machine-readable suggested_action, a human-readable action_reason, and LLM behavior recommendation.

// Your agent calls this automatically:
get_human_state({ session_id: "sess_abc123" })

// Response:
{
  "state": "stressed",
  "stress_score": 67,
  "confidence": 0.85,
  "signals_received": ["cardiovascular", "vocal"],
  "suggested_action": "de-escalate_and_shorten",
  "action_reason": "elevated heart rate + tense vocal tone",
  "recommendation": "Max 2 sentences. Direct, factual, no ambiguity."
}

ingest

Send human signals from any sensor. Requires session_id + timestamp + at least one signal field.

Key Parameters:

  • session_id (string, required)
  • timestamp (string, required, ISO 8601)
  • heart_rate, rmssd, sdnn — cardiovascular
  • tone, speech_rate — vocal
  • expression, gaze — visual
  • sentiment, urgency — textual
  • user_message, ai_response — for Trigger Memory
  • 50+ additional fields across 10 signal categories

get_trigger_memory

Retrieve the psychological trigger profile for a subject.

Parameters:

  • subject_id (string, required) — Persistent user identifier

Returns: Active triggers (currently causing stress), resolved triggers (stress decreased), with session counts.

get_trigger_memory({ subject_id: "user-123" })

// Response:
{
  "triggers": {
    "work_deadline": { "status": "active", "avg_stress": 74, "sessions": 5 },
    "relationship": { "status": "resolved", "avg_stress": 31, "sessions": 3 }
  }
}

get_session_history

Get state history over time.

Parameters:

  • session_id (string, required)
  • minutes (int, optional, default: 5)

Returns: Array of timestamped state snapshots with stress scores.

delete_subject

Permanently delete all data for a subject. Cascading: removes all sessions, trigger memory, and stored signals. Irreversible.

Parameters:

  • subject_id (string, required)