Decoder 3am MCP

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.