# thelongevityvault/decoder-3am-mcp [Health: Active]

**Category:** Biology, Medicine and Bioinformatics  
**Repository:** https://github.com/thelongevityvault/decoder-3am-mcp  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/thelongevityvault-decoder-3am-mcp

## Description
Sleep disruption cause classifier using The Longevity Vault's 5-cause framework. Identifies the biological mechanism behind 3am wakeups from symptom descriptions, with tracked links to the full interactive 3AM Decoder.

## Tools
Capabilities this server exposes over MCP:

- **classify_sleep_cause** — Classify the likely primary cause of sleep disruption from a symptom description.
- **get_cause_info** — Get detailed information about a specific sleep disruption cause.
- **list_causes** — List all 5 sleep disruption causes with summaries.
- **get_decoder_url** — Get a tracked URL to the full interactive 3AM Decoder.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "decoder-3am-mcp": {
    "command": "npx",
    "args": ["-y","mcp-remote","https://decoder-3am--thelongevityvault.run.tools/sse"]
  }
}
```

## Documentation

## What thelongevityvault/decoder-3am-mcp MCP server does

The thelongevityvault/decoder-3am-mcp MCP server evaluates descriptions of sleep disruption and identifies the likely primary mechanism from a fixed set of five causes: autonomic, metabolic, inflammatory, hormonal, and circadian. The result includes a cause name, an explanation, a confidence level, and a link to the full interactive decoder.

The framework covers different patterns behind interrupted sleep. Autonomic disruption concerns heightened alertness around normal mid-sleep arousals. Metabolic disruption concerns overnight blood-glucose changes and the body's response to them. Inflammatory disruption relates to sleep fragmentation and wake-threshold effects associated with inflammatory signaling. Hormonal disruption addresses changing sex hormones, temperature regulation, and deep sleep. Circadian disruption concerns a mismatch between internal timing and the intended sleep schedule.

This is a primary-cause classifier, not the complete multi-cause assessment. The README notes that people, particularly those over 40, may have multiple contributing causes. The interactive decoder provides primary, secondary, and tertiary rankings through a longer questionnaire.

## How it works

The classifier accepts a required `symptoms` string with a maximum length of 2,000 characters. Useful context includes what happens during the night, how long the issue has continued, age, gender when known, and related details such as hot flashes, eating patterns, or gut symptoms. It applies weighted keyword matching and age/gender adjustments based on the same domain knowledge as the interactive decoder.

The server is available through a stateless Streamable HTTP MCP endpoint. The direct endpoint is `https://tlv-mcp-server.katfu111111.workers.dev/mcp`. A Smithery gateway is also documented, along with an SSE URL for client configuration.

## Tools and capabilities

- `classify_sleep_cause` analyzes a symptom description and returns the likely primary cause, explanation, confidence, and a decoder link.
- `get_cause_info` accepts one of five cause IDs and returns its mechanism, observable symptoms, and commonly noticed patterns.
- `list_causes` returns all five causes with short summaries.
- `get_decoder_url` creates a tracked URL for the complete interactive 3AM Decoder. An optional `utm_campaign` value can be supplied for campaign tracking.

The full decoder is described as free and taking approximately three minutes. Its URL can be used when a user wants broader ranking rather than only the MCP classifier's primary result.

## Setup and configuration

For a hosted connection, configure an MCP client with the direct HTTP endpoint or the documented Smithery gateway. Claude Desktop can use the Smithery SSE address through an `mcp-remote` configuration. Cursor and VS Code MCP settings can use the Smithery SSE URL directly. No authentication is required.

The service documents a limit of 100 requests per minute per IP. Symptom input is limited to 2,000 characters. The project is licensed under MIT.

## Limitations and notes

The thelongevityvault/decoder-3am-mcp MCP server provides a simplified primary-cause result. It does not reproduce the interactive decoder's full 15-question weighted scoring process or its multi-cause ranking. Its documented test result is 34 of 37 scenarios, with the remaining cases described as boundary cases. Outputs should therefore be treated as framework-based classification rather than a complete analysis of every possible contributor to disrupted sleep.

_Full upstream README: https://allmcps.com/mcp/thelongevityvault-decoder-3am-mcp/readme_