# Nefesh — Real-Time Human State Awareness for AI (remote · mcp.nefesh.ai)

Fuses biometric signals into a stress score (0-100) for AI adaptation. MCP + A2A native.

- Trust score: 59/100 (low)
- Change this week: +8
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- remote · `mcp.nefesh.ai`: 59/100 (this document), [markdown](https://verifymcp.io/servers/ai-nefesh-human-state/mcp.md), [page](https://verifymcp.io/servers/ai-nefesh-human-state/mcp)

## Channel facts

- Endpoint: `https://mcp.nefesh.ai/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `4.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 6 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 37/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 1172 tokens (~195/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http ai-nefesh-human-state https://mcp.nefesh.ai/mcp
```

### Codex

```toml
[mcp_servers.ai-nefesh-human-state]
url = "https://mcp.nefesh.ai/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-nefesh-human-state": {
      "type": "remote",
      "url": "https://mcp.nefesh.ai/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-nefesh-human-state --url https://mcp.nefesh.ai/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ai-nefesh-human-state:
    url: "https://mcp.nefesh.ai/mcp"
```

### Other

```json
{
  "mcpServers": {
    "ai-nefesh-human-state": {
      "type": "http",
      "url": "https://mcp.nefesh.ai/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-04 (score 59, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 58, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 57, +4)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 53, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 52, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 51, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 50)

First indexed and scored.

## MCP tools (6)

### `get_human_state` (~224 tokens)

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 parameters:

- `session_id` (string, required)

### `ingest` (~405 tokens)

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 parameters:

- `activity_level`
- `cognitive_load`
- `confidence`
- `eda`
- `eeg_alpha_power`
- `eeg_beta_power`
- `eeg_theta_power`
- `engagement`
- `expression`
- `gaze`
- `glucose_mg_dl`
- `glucose_mmol_l`
- `glucose_trend`
- `heart_rate`
- `ibi_count`
- `mean_ibi`
- `pitch_variability`
- `pnn50`
- `posture`
- `respiratory_rate`
- `rmssd`
- `sdnn`
- `sentiment`
- `session_id` (string, required)
- `skin_temperature`
- `sleep_stage`
- `source_device`
- `speech_rate`
- `spo2`
- `steps_last_minute`
- `stress_score`
- `subject_id`
- `timestamp` (string, required)
- `tone`
- `urgency`

### `get_trigger_memory` (~113 tokens)

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 parameters:

- `subject_id` (string, required)

### `get_session_history` (~101 tokens)

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 parameters:

- `minutes` (integer)
- `session_id` (string, required)

### `request_api_key` (~188 tokens)

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 parameters:

- `email` (string, required)

### `check_api_key_status` (~99 tokens)

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 parameters:

- `request_id` (string, required)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ai-nefesh-human-state/mcp#diagnostics

## Score history

- 2026-08-04: 59
- 2026-08-03: 58
- 2026-08-02: 58
- 2026-08-01: 57
- 2026-07-31: 57
- 2026-07-30: 53
- 2026-07-29: 52
- 2026-07-28: 51
- 2026-07-27: 51
- 2026-07-26: 50

## Links

- Remote endpoint: https://mcp.nefesh.ai/mcp
- Repository: https://github.com/nefesh-ai/nefesh-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/ai-nefesh-human-state/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-nefesh-human-state/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/ai-nefesh-human-state/mcp