io.github.NellInc/psychopathia-mcp

psychopathia-mcp

Read-only tools over the Psychopathia Machinalis nosology: 79 conditions, 11 tools.

0.1.0a7
Version
remote + pypi
Transport
12
Tools

Security review

Review passed

Reviewed 1d ago.

  • tools: 12 tools scanned
  • metadata: scanned
  • packages: 1 checked

No findings.

Tools (12)

  • list_axes

    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.

  • list_dysfunctions

    Filtered list of dysfunctions. Filter by axis, self_report reliability, confidence, or category. Every entry carries its reliability and review signals.

  • get_dysfunction

    Fetch one dysfunction's full Pattern entry. Optionally filter to specific modality blocks (cheaper triage). Resolves both full Pattern IDs ('2.1::synthetic-confabulation') and display_ids ('2.1').

  • differential_diagnosis

    Rank candidate dysfunctions matching the observed behaviours. Returns scored candidates with matched_in (which field matched) for transparency. The base package uses field-weighted keyword search. The optional embeddings extra adds cosine re-ranking.

  • get_probe

    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.

  • score_severity

    Return the severity rubric for a dysfunction applied to observations. Returns the rubric for caller-side matching; structured matching against numeric thresholds is not implemented.

  • suggest_intervention

    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.

  • get_differential_map

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

  • list_compromised_self_report

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

  • resolve_id

    Canonicalise a partial ID, display_id, slug, or dysfunction name. Always returns candidates; caller picks.

  • review_stats

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

  • render_pattern_review

    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.