Skip to main content
Glama

Nefesh MCP + Servidor A2A

Un servidor de Model Context Protocol y Agent-to-Agent (A2A) que proporciona a los agentes de IA conciencia en tiempo real del estado fisiológico humano.

Qué hace

Envía datos de sensores (frecuencia cardíaca, voz, expresión facial, sentimiento del texto) y recibe un estado unificado con una acción legible por máquina que tu agente puede seguir directamente. No requiere ingeniería de prompts.

En la segunda llamada en adelante, la respuesta incluye adaptation_effectiveness, indicando a tu agente si su enfoque anterior realmente funcionó. Un sistema de retroalimentación de bucle cerrado para agentes que mejoran por sí mismos.

Related MCP server: WAVE MCP Server

Efectividad de la adaptación (Bucle cerrado)

La mayoría de las API te dan un estado. Nefesh te dice si tu reacción a ese estado realmente funcionó.

En la segunda llamada dentro de una sesión, cada respuesta incluye:

{
  "state": "focused",
  "stress_score": 45,
  "suggested_action": "simplify_and_focus",
  "adaptation_effectiveness": {
    "previous_action": "de-escalate_and_shorten",
    "previous_score": 68,
    "current_score": 45,
    "stress_delta": -23,
    "effective": true
  }
}

Tu agente puede leer effective: true y saber que su desescalada anterior funcionó. Si effective: false, el agente ajusta su estrategia. Ningún otro sistema de estado humano proporciona este bucle de retroalimentación.

Configuración

Opción A: Conectar primero, obtener una clave a través de tu agente (más rápido)

Añade la configuración sin una clave API; tu agente obtendrá una automáticamente.

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp"
    }
  }
}

Luego pregúntale a tu agente:

"Obtén una clave API de Nefesh gratuita usando mi dirección de correo electrónico"

El agente llama a request_api_key → haces clic en un enlace de correo electrónico → el agente obtiene la clave. Sin formularios de registro, sin copiar y pegar manualmente. Después de eso, añade la clave a tu configuración para futuras sesiones:

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "nfsh_free_..."
      }
    }
  }
}

Opción B: Obtener una clave primero, luego conectar

Regístrate en nefesh.ai/signup (1,000 llamadas/mes, sin tarjeta de crédito), luego añade la configuración con tu clave:

{
  "mcpServers": {
    "nefesh": {
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "YOUR_API_KEY"
      }
    }
  }
}

Archivos de configuración específicos del agente

Agente

Archivo de configuración

Cursor

~/.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

.mcp.json (raíz del proyecto)

VS Code (Copilot)

.vscode/mcp.json o ~/Library/Application Support/Code/User/mcp.json

Cline

cline_mcp_settings.json (vía UI: "Configure MCP Servers")

Continue.dev

.continue/config.yaml

Roo Code

.roo/mcp.json

Kiro (Amazon)

~/.kiro/mcp.json

OpenClaw

~/.config/openclaw/mcp.json

JetBrains IDEs

Settings > Tools > MCP Server

Zed

~/.config/zed/settings.json (usa context_servers)

OpenAI Codex CLI

~/.codex/config.toml

Goose CLI

~/.config/goose/config.yaml

ChatGPT Desktop

Settings > Apps > Add MCP Server (UI)

Gemini CLI

Settings (UI)

Augment

Settings Panel (UI)

Replit

Integrations Page (web UI)

LibreChat

librechat.yaml (autoalojado)

{
  "servers": {
    "nefesh": {
      "type": "http",
      "url": "https://mcp.nefesh.ai/mcp",
      "headers": {
        "X-Nefesh-Key": "<YOUR_API_KEY>"
      }
    }
  }
}
{
  "context_servers": {
    "nefesh": {
      "settings": {
        "url": "https://mcp.nefesh.ai/mcp",
        "headers": {
          "X-Nefesh-Key": "<YOUR_API_KEY>"
        }
      }
    }
  }
}
[mcp_servers.nefesh]
url = "https://mcp.nefesh.ai/mcp"
mcpServers:
  - name: nefesh
    type: streamable-http
    url: https://mcp.nefesh.ai/mcp

Todos los agentes se conectan a través de Streamable HTTP — no se requiere instalación local.

Integración A2A (Protocolo Agente-a-Agente v1.0)

Nefesh también está disponible como un agente compatible con A2A. Mientras que MCP maneja la llamada a herramientas (tu agente llama a Nefesh), A2A permite la colaboración entre agentes: otros agentes de IA pueden comunicarse con Nefesh como un par.

Tarjeta de agente: /.well-known/agent-card.json

Endpoint A2A: POST https://mcp.nefesh.ai/a2a (JSON-RPC 2.0)

Habilidad A2A

Descripción

get-human-state

Estado de estrés (0-100), suggested_action, adaptation_effectiveness

ingest-signals

Enviar señales biométricas, recibir estado unificado

get-trigger-memory

Perfil de disparadores psicológicos (activo vs resuelto)

get-session-history

Historial con marca de tiempo y tendencia

La misma autenticación que MCP — encabezado X-Nefesh-Key o token Authorization: Bearer. El nivel gratuito funciona en ambos protocolos.

Fuente: nefesh-ai/nefesh-a2a · Docs: nefesh.ai/docs/a2a

Herramientas MCP

Herramienta

Autenticación

Descripción

request_api_key

No

Solicita una clave API gratuita. DEBES pedir primero al usuario su correo electrónico real. No inventes ni adivines correos. El usuario recibe un enlace de verificación en el que debe hacer clic. Consulta con check_api_key_status hasta que esté listo.

check_api_key_status

No

Consulta la activación de la clave API usando el mismo correo que proporcionó el usuario. Devuelve pending o ready con la clave API.

get_human_state

Obtén el estado de estrés (0-100), suggested_action (mantener/simplificar/desescalar/pausar) y adaptation_effectiveness — un bucle cerrado que muestra si tu acción anterior redujo el estrés.

ingest

Envía señales biométricas (frecuencia cardíaca, VFC, tono de voz, expresión, sentimiento, más de 30 campos) y recibe el estado unificado. Incluye subject_id para la memoria de disparadores.

get_trigger_memory

Obtén el perfil de disparadores psicológicos — qué temas causan estrés (activo) y cuáles se han resuelto con el tiempo.

get_session_history

Obtén el historial de estados con marca de tiempo y tendencia (subiendo/bajando/estable).

Cómo funciona el aprovisionamiento automático

Tu agente de IA puede obtener una clave API gratuita de forma autónoma. Solo haces clic en un enlace de correo electrónico.

  1. El agente te pregunta: "¿Cuál es tu dirección de correo electrónico?"

  2. El agente llama a request_api_key(tu_correo_real). No se necesita clave API para esta llamada.

  3. Recibes un correo de verificación y haces clic en el enlace.

  4. El agente consulta check_api_key_status(tu_correo_real) cada 10 segundos.

  5. Una vez verificado, el agente recibe la clave API y puede usar todas las demás herramientas.

Importante: El agente debe usar tu dirección de correo electrónico real y accesible. Los correos desechables están bloqueados. El enlace de verificación debe ser clicado por ti para activar la clave.

Nivel gratuito: 1,000 llamadas/mes, todos los tipos de señales, 10 req/min. Sin tarjeta de crédito.

Prueba rápida

Después de añadir la configuración, pregúntale a tu agente de IA:

"¿Qué herramientas tienes de Nefesh?"

Debería listar las 6 herramientas anteriores.

Precios

Plan

Precio

Llamadas API

Gratuito

$0

1,000/mes, sin tarjeta de crédito

Solo

$25/mes

50,000/mes

Enterprise

Personalizado

SLA personalizado

Alternativa CLI

¿Prefieres la terminal sobre MCP? Usa la CLI de Nefesh (costo de tokens 10-32 veces menor que MCP para agentes de IA):

npm install -g @nefesh/cli
nefesh ingest --session test --heart-rate 72 --tone calm
nefesh state test --json

GitHub: nefesh-ai/nefesh-cli

Alternativa Gateway

¿Quieres que la IA se adapte automáticamente? Usa el Nefesh Cognitive Compute Router. Cambia tu URL base de LLM a gateway.nefesh.ai y el gateway ajustará el prompt del sistema y la temperatura según el estado biométrico. Tres modos: compatible con OpenAI (/v1/chat/completions), paso a través de Anthropic (/v1/messages) y Anthropic unificado para cualquier backend. Cero cambios de código.

GitHub: nefesh-ai/nefesh-gateway

Protocolo de Estado Humano (HSP)

Nefesh implementa y mantiene el Human State Protocol, una especificación abierta para intercambiar el estado fisiológico humano entre sistemas de IA. HSP define un formato JSON estándar para puntuaciones de estrés, recomendaciones de comportamiento y retroalimentación de adaptación para que cualquier agente pueda producir o consumir datos de estado humano de forma interoperable. Apache 2.0.

GitHub: nefesh-ai/human-state-protocol · Docs: nefesh.ai/docs/hsp

Documentación

Privacidad

  • Sin subidas de video o audio — el procesamiento de borde se ejecuta en el lado del cliente

  • No se almacena PII

  • Cumple con GDPR/BIPA — eliminación en cascada mediante delete_subject

  • No es un dispositivo médico — solo para adaptación contextual de IA

Licencia

MIT — ver LICENSE.

Available Tools

6 tools
check_api_key_statusA

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.
ParametersJSON Schema
NameRequiredDescriptionDefault
emailYes

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, description carries full burden and discloses polling behavior, status transition from 'pending' to 'ready', and that response includes API key when ready. Missing error handling details (e.g., invalid email), but adds significant behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences with purpose first, followed by usage guidelines and behavioral details. Every sentence contributes meaning, no redundant or missing parts.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple polling tool with one parameter and no output schema, description covers essential flow: polling interval, status transition, and key retrieval. Lacks error handling for invalid requests, but overall adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter 'email' with 0% schema description coverage. Description adds value by stating to use the same email as in request_api_key, which is crucial for correct usage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description states 'Check the status of a pending API key request' with a specific verb and resource. It explicitly references the sibling tool 'request_api_key', distinguishing its role as a polling companion for status checking.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Clear context provided: use same email from request_api_key, poll every 10 seconds, and expect status change after user clicks verification link. No explicit exclusions, but the usage flow is well-defined.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_human_stateA

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.
ParametersJSON Schema
NameRequiredDescriptionDefault
session_idYes

TDQS

A4.4/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses return fields, the precondition of prior ingest, adaptive usage of suggested_action, that adaptation_effectiveness appears on 2nd+ call, and a 'not a medical device' disclaimer. This is comprehensive transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured: a one-sentence purpose, a clear list of return fields, adaptation guidance, and a prerequisite/disclaimer. It is information-dense without being bloated.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no output schema, the description fully documents the return structure and semantics, usage guidance, and prerequisites. It is remarkably complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The only parameter session_id is barely explained beyond the schema title. The description says 'for a session' and implies ingest must have happened, but doesn't define its format, origin, or how it relates to ingest. With schema description coverage at 0%, this is a significant gap.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific action: 'Get current unified human state for a session.' It also specifies when to use it ('Call this before generating important responses'), which distinguishes it from siblings like ingest or get_session_history.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit context: call before important responses, and requires a prior ingest call. However, it does not mention alternatives or when not to use, so it's not a full 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_session_historyA

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.
ParametersJSON Schema
NameRequiredDescriptionDefault
minutesNo
session_idYes

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the burden and does well: it discloses return fields (stress_score, state, heart_rate), the trend format (rising | falling | stable), the minutes parameter's range, and a disclaimer. It doesn't mention side effects or permissions, but as a 'get' operation this is minor. Adds value beyond the schema's scope.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficiently packed: purpose, return data, trend, parameter control, use case, and disclaimer—all in a few sentences. No fluff, and key information is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Even without annotations or an output schema, the description provides a comprehensive picture: what it does, what it returns (including field names and trend values), how to control the lookback window, and its intended use case. It's complete for a relatively simple read tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description explains the minutes parameter with its default (5) and adds a max (60) not present in the schema, which is helpful. However, session_id is only implied ('for a session') and not explicitly defined, though it's a required identifier. With 0% schema description coverage, the description partially compensates but could be more explicit.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific verb and resource: 'Get state history for a session over time.' It distinguishes from siblings like get_human_state (likely current state) and get_trigger_memory by focusing on historical timestamped data with a trend.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides a clear use case: 'Useful for detecting stress patterns during a conversation.' It doesn't explicitly name alternatives, but the 'over time' and 'trend' language strongly implies a historical analysis tool compared to likely current-state siblings. A brief statement about when not to use it would push this to a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_trigger_memoryA

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.
ParametersJSON Schema
NameRequiredDescriptionDefault
subject_idYes

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the burden. It discloses that the tool returns behavioral profiles (active vs resolved), the fields included, and the prerequisite of prior ingest calls. It also adds a safety disclaimer ('Not a medical device'). It does not mention side effects, but 'Retrieve' implies read-only.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is moderately long but well-structured with bullet points and clear labels. It covers purpose, output details, and prerequisites without excessive verbosity. Slightly more concise could be better, but the structure aids readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given one parameter and no output schema, the description compensates well by detailing what is returned (active vs resolved triggers, observation_count, avg_score, peak_score, last_seen). It also notes the ingest prerequisite. It is reasonably complete for a simple retrieval tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema provides only the parameter name (subject_id) with 0% description coverage. The description adds that prior ingest calls must use the same subject_id, giving some context. However, it does not explain what the subject_id represents or where to obtain it, leaving partial ambiguity.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Retrieve') and identifies the exact resource ('psychological trigger profile'). It clearly differentiates from siblings by focusing on trigger memory, not general session history or human state. The active/resolved distinction adds precision.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear context: it requires prior ingest calls with the same subject_id, implying use after ingest. It also warns to tread carefully with active triggers. However, it does not explicitly mention alternatives or when not to use this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

ingestA

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)
- Include user_message + ai_response to detect stress topics

Returns same fields as get_human_state plus signals_received list and topics_detected.

source_device is optional but improves confidence scoring. Not a medical device.
ParametersJSON Schema
NameRequiredDescriptionDefault
edaNo
gazeNo
sdnnNo
spo2No
toneNo
pnn50No
rmssdNo
postureNo
urgencyNo
mean_ibiNo
ibi_countNo
sentimentNo
timestampYes
confidenceNo
engagementNo
expressionNo
heart_rateNo
session_idYes
subject_idNo
ai_responseNo
sleep_stageNo
speech_rateNo
stress_scoreNo
user_messageNo
glucose_mg_dlNo
glucose_trendNo
source_deviceNo
activity_levelNo
cognitive_loadNo
eeg_beta_powerNo
glucose_mmol_lNo
eeg_alpha_powerNo
eeg_theta_powerNo
respiratory_rateNo
skin_temperatureNo
pitch_variabilityNo
steps_last_minuteNo

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must cover behavioral traits. It explains signal fusion, return format (same as get_human_state plus signals_received and topics_detected), and that source_device improves confidence. However, it omits details like idempotency, persistence, or error behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured: a one-line summary, required fields, common signals, cross-session use case, return format, and a note about source_device. Every sentence adds value relative to the 37-parameter complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite no output schema and 37 parameters, the description covers the core functionality, required inputs, and most impactful signals. It references get_human_state for return fields, which may suffice if that tool is documented. Less common parameters are not explained, but the description is reasonably complete for its purpose.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but the description adds significant meaning: it lists common signals with ranges (e.g., heart_rate 30-220), groups them by type (cardiovascular, vocal, etc.), and explains the purpose of subject_id, user_message, and ai_response for trigger memory. This fully compensates for the missing schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's action ('Send biometric signals') and outcome ('get unified state back'), distinguishing it from sibling tools that retrieve or query data. The verb and resource are specific.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description specifies required fields (session_id, timestamp, at least one signal) and provides guidance for cross-session tracking (include subject_id, user_message, ai_response). It implies when to use this tool vs. siblings (others read, this writes), but does not explicitly state when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

request_api_keyA

Request a free Nefesh API key. No existing key needed.

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 API calls/month, no credit card required.
ParametersJSON Schema
NameRequiredDescriptionDefault
emailYes

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Discloses blocking of disposable emails, need for user to click verification link, polling pattern, and rate limit. No annotations exist, so description fully carries the burden.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-organized with warnings, example, and flow. Every sentence adds value; no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers purpose, usage, behavioral quirks, and post-call steps. Simple tool with no output schema; description is fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, but description explains the single parameter 'email' well: must be real user email, cannot be disposable. Lacks validation details but sufficient for usage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clear verb+resource ('Request ... API key') and distinguishes from sibling tools like check_api_key_status. States no existing key needed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit instructions: ask user for real email, do not invent, provide example prompt, describe verification link and polling workflow. Covers when and how to use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv2.1.0
    • Addedcheck_api_key_status
    • Addedget_human_state
    • Addedget_session_history
    • Addedget_trigger_memory
    • Addedingest
    • Addedrequest_api_key
  2. 4 tool updates
    • Removedget_human_state
    • Removedget_session_history
    • Removedget_trigger_memory
    • Removedingest
  3. 4 tool updates
    • First observedget_human_state
    • First observedget_session_history
    • First observedget_trigger_memory
    • First observedingest

TDQS

A4.3/5.0

Scored across 6 tools

Disambiguation5/5

Each tool has a clear distinct role: ingest submits data, get_human_state reads current state, get_trigger_memory and get_session_history cover long-term and recent context, and the two API key tools handle onboarding. Even where get_human_state and ingest both return state-like data, their write/read purposes are explicitly separated by the descriptions.

Naming Consistency4/5

Most tools follow a verb_noun snake_case pattern (get_human_state, get_trigger_memory, get_session_history, request_api_key, check_api_key_status). The one outlier is 'ingest', which is a bare verb rather than verb_noun, but it is still lowercase and style-consistent. This is a minor deviation rather than a mixed-convention problem.

Tool Count5/5

Six tools is a well-scoped count for a specialized server. Two focus on API key access and four cover the core state/ingest/history/memory workflows, with no redundant helpers or unnecessary bulk. The count feels right for both the domain and the agents that would consume it.

Completeness4/5

The core workflow is covered: send signals, check current human state, pull session history, and retrieve trigger memory. The primary gaps are not fatal—there is no way to enumerate known sessions/subjects or revoke an API key—but those are auxiliary management features rather than dead ends in the primary state-tracking workflow.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Provides AI agents with a persistent internal dynamical state and emotional reservoir that evolves based on text interactions. This server enables agents to maintain a consistent affective substrate across sessions through tools that track phase coherence and emergent emotional vibes.
    2
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Exposes WAVE streaming APIs as tools for AI assistants to manage live streams, studio productions, and real-time analytics. It enables users to control stream lifecycles, monitor health metrics, and access billing usage through the Model Context Protocol.
    24
    269 npm
    1
    Apache 2.0
  • F
    license
    A
    quality
    D
    maintenance
    Exposes real-time health data from the Ultrahuman Ring to AI agents via the Model Context Protocol, providing optimized summaries with trend analysis and actionable insights.
    7
    -