MCP Server
Nefesh — Real-Time Human State Awareness for AI
ai.nefesh/human-state
What this MCP does
Processes biometric signals into a stress score for adapting AI interactions to a person's state.
Capabilities
Tools
6
tools
check_api_key_status
Check the status of a pending API key request.
Use the exact same email the user provided to request_api_key.
Poll this every 10 seconds. Once the user clicks the verification
link in their inbox, status changes from 'pending' to 'ready'
and the response includes the API key. Store it immediately â
returned once only. Expires after 15 minutes.
Input schema
{'type': 'object', 'title': 'check_api_key_statusArguments', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string', 'title': 'Request Id'}}}
get_human_state
Get current unified human state for a session. Call this before generating important responses.
Returns:
- state: calm | relaxed | focused | stressed | acute_stress
- stress_score: 0-100 (lower = calmer)
- confidence: 0.0-1.0 (based on signal quality and device type)
- suggested_action: maintain_engagement | simplify_and_focus | de-escalate_and_shorten | pause_and_ground
- action_reason: human-readable explanation of why this action was suggested
- adaptation_effectiveness (on 2nd+ call): shows whether your previous suggested_action actually reduced stress â contains previous_action, stress_delta, and effective boolean. Use this to self-improve.
Use suggested_action to adapt your response: calm/relaxed = full complexity, focused = shorter and structured, stressed = max 2 sentences, acute_stress = one grounding sentence only.
Requires a prior ingest call to have data. Not a medical device.
Input schema
{'type': 'object', 'title': 'get_human_stateArguments', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'title': 'Session Id'}}}
get_session_history
Get state history for a session over time.
Returns timestamped datapoints with stress_score, state, and heart_rate for each observation.
Includes an overall trend: rising | falling | stable.
Use minutes parameter to control the lookback window (default: 5, max: 60).
Useful for detecting stress patterns during a conversation. Not a medical device.
Input schema
{'type': 'object', 'title': 'get_session_historyArguments', 'required': ['session_id'], 'properties': {'minutes': {'type': 'integer', 'title': 'Minutes', 'default': 5}, 'session_id': {'type': 'string', 'title': 'Session Id'}}}
get_trigger_memory
Retrieve psychological trigger profile for a subject.
Returns which conversation topics consistently cause stress (active triggers) and which have been resolved over time.
- active triggers: topics where stress was elevated across multiple sessions. Tread carefully.
- resolved triggers: topics where stress has decreased. Safe to explore deeper.
Each trigger includes observation_count, avg_score, peak_score, and last_seen.
Requires prior ingest calls with the same subject_id. Not a medical device.
Input schema
{'type': 'object', 'title': 'get_trigger_memoryArguments', 'required': ['subject_id'], 'properties': {'subject_id': {'type': 'string', 'title': 'Subject Id'}}}
ingest
Send biometric signals from any sensor, get unified state back.
Required: session_id + timestamp (ISO 8601) + at least one signal.
Send whatever you have â the API fuses all signals into one state.
Common signals (highest impact):
- heart_rate (bpm, 30-220) + rmssd (ms) â cardiovascular
- tone: calm | tense | anxious | hostile â vocal
- sentiment: -1.0 to 1.0 â textual
- expression: relaxed | neutral | tense â visual
For trigger memory (cross-session psychological tracking):
- Include subject_id (consistent per user, hashed)
Returns same fields as get_human_state plus signals_received list and topics_detected (if conversation text was included).
source_device is optional but improves confidence scoring. Not a medical device.
Input schema
{'type': 'object', 'title': 'ingestArguments', 'required': ['session_id', 'timestamp'], 'properties': {'eda': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Eda', 'default': None}, 'gaze': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Gaze', 'default': None}, 'sdnn': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Sdnn', 'default': None}, 'spo2': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Spo2', 'default': None}, 'tone': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Tone', 'default': None}, 'pnn50': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Pnn50', 'default': None}, 'rmssd': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Rmssd', 'default': None}, 'posture': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Posture', 'default': None}, 'urgency': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Urgency', 'default': None}, 'mean_ibi': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Mean Ibi', 'default': None}, 'ibi_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Ibi Count', 'default': None}, 'sentiment': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Sentiment', 'default': None}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'confidence': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Confidence', 'default': None}, 'engagement': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Engagement', 'default': None}, 'expression': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Expression', 'default': None}, 'heart_rate': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Heart Rate', 'default': None}, 'session_id': {'type': 'string', 'title': 'Session Id'}, 'subject_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Subject Id', 'default': None}, 'sleep_stage': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Sleep Stage', 'default': None}, 'speech_rate': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Speech Rate', 'default': None}, 'stress_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Stress Score', 'default': None}, 'glucose_mg_dl': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Glucose Mg Dl', 'default': None}, 'glucose_trend': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Glucose Trend', 'default': None}, 'source_device': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Source Device', 'default': None}, 'activity_level': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Activity Level', 'default': None}, 'cognitive_load': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Cognitive Load', 'default': None}, 'eeg_beta_power': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Eeg Beta Power', 'default': None}, 'glucose_mmol_l': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Glucose Mmol L', 'default': None}, 'eeg_alpha_power': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Eeg Alpha Power', 'default': None}, 'eeg_theta_power': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Eeg Theta Power', 'default': None}, 'respiratory_rate': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Respiratory Rate', 'default': None}, 'skin_temperature': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Skin Temperature', 'default': None}, 'pitch_variability': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Pitch Variability', 'default': None}, 'steps_last_minute': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'title': 'Steps Last Minute', 'default': None}}}
request_api_key
Request a free Nefesh API key. No existing API key needed for this call.
IMPORTANT: You MUST ask the user for their real email address before
calling this tool. Do NOT invent, guess, or generate an email address.
The user will receive a verification link they must click to activate
the key. Without clicking that link, no API key will be issued.
Disposable or temporary email services are blocked.
Example prompt to the user: "What is your email address? You will
receive a verification link to activate your free API key."
Flow: call this with the user's real email, then poll
check_api_key_status every 10 seconds until status is 'ready'.
Free tier: 1,000 calls/month, all signal types, 10 req/min. No credit card.
Input schema
{'type': 'object', 'title': 'request_api_keyArguments', 'required': ['email'], 'properties': {'email': {'type': 'string', 'title': 'Email'}}}
History
Recent tool changes
Added
check_api_key_status
Sept. 17, 2026, 7:57 a.m.
Added
request_api_key
Sept. 17, 2026, 7:57 a.m.
Added
get_session_history
Sept. 17, 2026, 7:57 a.m.
Added
get_trigger_memory
Sept. 17, 2026, 7:57 a.m.
Added
ingest
Sept. 17, 2026, 7:57 a.m.
Added
get_human_state
Sept. 17, 2026, 7:57 a.m.
Discover
Similar MCP servers
fitbit
io.usefulapi/fitbit
Reads Fitbit profile, activity, sleep, nutrition, body measurements, heart metrics, oxygen data, temperature and device informati…
eliu243-oura-mcp-server-2
ai.smithery/eliu243-oura-mcp-server-2
Provides authenticated access to Oura Ring data for use in workflows.
eliu243-oura-mcp-server-eliu
ai.smithery/eliu243-oura-mcp-server-eliu
Connects securely to Oura Ring accounts to access sleep and activity data.
eliu243-oura-mcp-server
ai.smithery/eliu243-oura-mcp-server
Connects to Oura Ring accounts to access wellness data for applications and automations.
MaCalculatriceEnLigne
io.github.tresor4k/macalc-mcp
Provides calculators for French and Belgian taxes, salaries, pensions, VAT, loans, health metrics, education scores, fitness, and…
Clink Forge
com.clinkforge/clink-forge
Provides pay-per-call access to attested government datasets, primarily CDC and HHS health data plus EPA air-quality observations.
Good Turn Studio (all tools)
io.github.GoodTurnStudio/all
Offers consumer utilities for insurance claim appeals, subscription cancellation, flight fare research, financial recovery resour…
Feegow Clinic
io.github.mcp-dir/feegow-mcp
Manages clinic patients, providers, appointments, schedules, benefit plans, insurance billing, financial records, units, employee…