# human-state

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nefesh-ai/human-state

# Browse available tools
npx -y @smithery/cli@latest tool list nefesh-ai/human-state

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nefesh-ai/human-state get_human_state

# Call a tool
npx -y @smithery/cli@latest tool call nefesh-ai/human-state get_human_state '{}'
```

## Direct MCP Connection

Endpoint: `https://human-state--nefesh-ai.run.tools`

**Optional config:**
- `X-Nefesh-Key` (header) — API key. Free at nefesh.ai/signup. Optional: use request_api_key tool without key.

## Tools (6)

- `get_human_state` — Get current unified human state for a session. Call this before generating important responses.
- `ingest` — Send biometric signals from any sensor, get unified state back.
- `get_trigger_memory` — Retrieve psychological trigger profile for a subject.
- `get_session_history` — Get state history for a session over time.
- `request_api_key` — Request a free Nefesh API key. No existing API key needed for this call.
- `check_api_key_status` — Poll for API key activation after calling request_api_key. No existing API key needed.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nefesh-ai/human-state <tool-name>
```