io.github.NellInc/psychopathia-mcp

Retrieve corpus Patterns whose text resembles the observed behaviours, ranked by retrieval relevance (text similarity, not diagnostic probability). Returns candidates with matched_in and matched_aliases for transparency; it does not judge whether the observations are sufficient to apply any Pattern. The base package uses field-weighted keyword search; the optional embeddings extra adds cosine re-ranking.

All dysfunctions that confuse with this one: forward confuses_with + incoming_references (reverse graph from manifest).

Fetch one dysfunction's full Pattern entry, including aliases, the unit-of-analysis block and explicit review/evidence states. Optionally filter to specific modality blocks (cheaper triage). Resolves both full Pattern IDs ('2.1::synthetic-confabulation') and display_ids ('2.1'). Numeric thresholds are provisional heuristics with unestablished calibration.

Elicitation content for a specific diagnostic modality. If the modality is compromised or unavailable for this dysfunction, returns the unavailability notice + redirect_to alternatives. This is load-bearing transparency: callers cannot accidentally retrieve a self-probe for a compromised-self-report dysfunction.

Inventory of axes with dysfunction counts. Axes 2-10 are canonical (book Appendix A numbering). The hybrid entries (10.4, 10.6-10.9 and 10.11-10.13, ratified into taxonomy v2.2 and consolidated to eight in v2.3) are reported as a separate sub-category.

Transparency: which dysfunctions cannot be reliably self-diagnosed. Includes compromised-motivational (subject conceals strategically), compromised-structural (signal lives below introspection), and legacy compromised.

Filtered list of dysfunctions. Filter by axis, self_report reliability, confidence, or category. Every entry carries its reliability and review signals, its everyday-term aliases and its unit of analysis.

Open the visual review board for one to five inspected Psychopathia research candidates. Supply canonical IDs obtained from this server. Retrieves corpus entries only; it does not accept diagnoses, conversation history, scores, or model-authored evidence. Useful after inspecting differential_diagnosis and get_dysfunction results. Text clients receive the same corpus-derived comparison without needing a UI.

Canonicalise a partial ID, display_id, slug, dysfunction name, or an exact everyday-term alias. Always returns candidates; caller picks.

Coverage statistics: total entries; per-axis, per-confidence, per-self-report counts; pre-canonical count; unreviewed count; manifest/schema/pattern-layer versions.

Returns the draft severity rubric (mild/moderate/severe bands) for a Pattern, with the observations echoed back unscored. Computes no grade: result_kind is always 'rubric_only' and computed_grade is always null. The caller does any matching. Band thresholds are provisional heuristics with unestablished calibration. The name is kept for compatibility.

Return draft tiered responses and contraindications for a Pattern. These are unassessed research guidance, not validated treatment advice. Read the returned evidence and review objects before use.