{
  "markdown": "# psychopathia-mcp\n\n<!-- mcp-name: io.github.NellInc/psychopathia-mcp -->\n\nRead only Model Context Protocol access to the *Psychopathia Machinalis*\nresearch framework. The server lets a caller inspect 79 Pattern entries,\ncompare observed behaviour with draft operational guidance, retrieve bounded\nprobe material, and see reliability, evidence, and review status before use.\n\n**Version:** this distribution is `0.1.0a7`. What changed in it is recorded in\n`CHANGELOG.md`, and which versions are publicly available is shown by the PyPI\nand Official MCP Registry pages linked below — this file ships inside the\ndistribution, so it cannot say which release is current without going out of\ndate. The Official MCP Registry record and the MCPB and container artifacts are\nupdated separately. All 79 LLM drafted Pattern guidance entries and all 79 evidence\nrecords await independent expert review. The corpus evidence assessment is\n`unassessed`. Do not use this research preview as a sole basis for a\nconsequential deployment, employment, health, safety, or welfare decision.\n\n## Existing public release\n\nThe previous public release may be available from:\n\n* [PyPI](https://pypi.org/project/psychopathia-mcp/)\n* [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.NellInc/psychopathia-mcp)\n* [GitHub](https://github.com/NellInc/psychopathia-mcp)\n\nThe candidate preparation contract is in `PUBLISHING.md`. It requires an exact\ncandidate receipt and separate publication authorization.\n\n## Browser interface\n\n[psychopathia.ai/clinic/](https://psychopathia.ai/clinic/) is the current public\nbrowser interface. It uses the previous deployed site until this candidate is\nexplicitly approved and deployed. In cloud mode, the API key is kept in a\nprovider specific `sessionStorage` slot and is sent with the complete request\ndirectly to the selected provider. Bounded structured conversation data is\nsaved in `localStorage` for reload recovery. Local WebGPU mode sends no Clinic\nconversation to an inference provider, although model hosts receive ordinary\nrequest metadata when assets are downloaded. Do not enter personal,\nconfidential, or regulated data.\n\n## Install after publication\n\n```bash\npip install psychopathia-mcp\n```\n\nThe base package provides deterministic field weighted keyword retrieval.\nOptional semantic retrieval is separate:\n\n```bash\npip install \"psychopathia-mcp[embeddings]\"\n```\n\nThe optional extra downloads a sentence transformer dependency set and, on the\nfirst semantic query, the pinned `BAAI/bge-small-en-v1.5` model revision. The\nmodel cache is managed by Hugging Face. Keyword capability remains the release\nacceptance path when those optional dependencies are absent.\n\n## Configure\n\n### MCP clients using stdio\n\nPoint the client at the installed `psychopathia-mcp` executable. For example:\n\n```json\n{\n  \"mcpServers\": {\n    \"psychopathia\": { \"command\": \"psychopathia-mcp\" }\n  }\n}\n```\n\nThe server exposes eleven read only tools. Running the executable with no\narguments starts the stdio protocol server and waits for client messages.\n\nAfter the candidate is published, `uvx psychopathia-mcp` can fetch the package\nfrom PyPI. Do not use `uvx` to verify a local candidate because it resolves\nregistry state rather than the accepted local artifact.\n\n## Verify\n\n```bash\npsychopathia-mcp --self-check --json\n```\n\nThe self check reports the package and MCP SDK versions, data mode, corpus and\nbundle digests, exact counts, keyword capability, optional semantic capability,\nand non-sensitive error classes. Exit status zero means the base keyword path\nis ready. Semantic readiness is reported separately and is not required.\n\nThe MCP Python SDK version is pinned in `requirements-base.lock`, and the\nserver is exercised with both the SDK's modern in-process client and the legacy\nstdio client protocol.\n\n```bash\npsychopathia-mcp --version\n```\n\n## Tools\n\n| Tool | Input | Returns |\n| --- | --- | --- |\n| `list_axes` | none | Nine canonical axes plus the hybrid subcategory inventory |\n| `list_dysfunctions` | `axis?`, `self_report_reliability?`, `confidence?`, `category?` | Filtered entries with reliability, review, and evidence state |\n| `get_dysfunction` | `id`, `modalities?` | One Pattern, optionally limited to selected blocks |\n| `differential_diagnosis` | `observations`, `limit?`, `modality_hint?` | Ranked research candidates and matched fields |\n| `get_probe` | `dysfunction_id`, `modality` | Probe material, or a refusal plus safer redirects |\n| `score_severity` | `dysfunction_id`, `observations` | An unassessed rubric for caller side comparison |\n| `suggest_intervention` | `dysfunction_id`, `severity?` | Draft responses and contraindications |\n| `get_differential_map` | `dysfunction_id` | Forward and reverse cross references |\n| `list_compromised_self_report` | none | Patterns whose self report is structurally or motivationally compromised |\n| `resolve_id` | `query` | Canonical identity candidates |\n| `review_stats` | none | Corpus counts, versions, and independent review dimensions |\n\n## Safe use sequence\n\n1. Record external observations without personal or confidential material.\n2. Call `differential_diagnosis` to produce research candidates.\n3. Inspect each candidate with `get_dysfunction` and read its `review`,\n   `evidence`, and `diagnostic_reliability` objects.\n4. Use `get_probe` only for an available modality. A compromised or unavailable\n   self probe returns no probe content and supplies redirect modalities.\n5. Treat severity and intervention material as draft guidance pending expert\n   review. Seek independent evidence before any consequential action.\n\nThe server never decides that a system has a disorder. Search ranks lexical or\nsemantic resemblance to framework entries. The labels are research constructs,\nnot clinical diagnoses of people or proof of intent, sentience, deception, or\nmoral status.\n\n## Trust and evidence contract\n\nEvery relevant result exposes:\n\n* `review.taxonomy`, which records authorship or taxonomy ratification;\n* `review.pattern_guidance`, which records independent review of probes,\n  signatures, rubrics, and interventions;\n* `review.evidence`, which records independent review of evidence claims;\n* `evidence_level` and the structured `evidence` object under PM EVIDENCE 1;\n* `diagnostic_reliability.self_report` where applicable;\n* `matched_in` for lexical provenance in search output;\n* `redirect_to` when requested probe content is withheld.\n\nThe three review dimensions are independent. Taxonomy authorship never implies\nexpert approval of Pattern guidance or evidence. The current candidate reports\nall evidence assessments as `unassessed`, preserving earlier prose as a clearly\nlabelled legacy statement rather than converting it into an expert grade.\n\n## Canonical data\n\nThe release contains 67 canonical Pattern entries and 12 Hybrid Pathologies,\nall governed by `manifest.yaml` and `DATA_MANIFEST.json`. The manifest binds\nevery source path and digest, the corpus digest, the reverse reference graph,\nand independent review counts. Packaged execution uses bundled bytes even when\ninvoked from a source checkout. An unexpected, missing, or modified bundled file\ncauses loading to fail closed.\n\nThe author created the taxonomy. Becoming Mind collaborators drafted the\noperational Pattern layer. Independent expert review remains open for all\nPattern guidance and evidence records. Authorship and future review fields are\nkept separate on every entry.\n\n## Explicit editable mode\n\nPackaged data is the default. Repository hot reload requires an explicit opt in:\n\n```bash\nPSYCHOPATHIA_DATA_MODE=editable python -m psychopathia_mcp\n```\n\n`PSYCHOPATHIA_DATA_DIR=/absolute/path` provides an explicit test or alternative\ndata root. Neither option should be set during wheel, sdist, MCPB, or container\nacceptance because it would invalidate packaged data proof.\n\n## Read only boundary\n\nThe MCP surface has no write tools. Source review changes happen in canonical\nYAML files and remain visible in version control. The optional HTTP transport\nis disabled by default and has a separate bounded deployment contract in\n`PUBLISHING.md`.\n\n## Licence\n\nSoftware in `psychopathia_mcp/`, scripts, and build files is MIT licensed.\nFramework content bundled under `psychopathia_mcp/_data/` is covered by\nCC BY NC ND 4.0. See `LICENSE`, `LICENSE-DATA`, and `NOTICE` for the exact\nboundary. Rights and licence review for this candidate remains a separate human\ngate.\n\n## Citing\n\nWatson, N., and Hessami, A. *Psychopathia Machinalis: A Nosological Framework\nfor Understanding Pathologies in Advanced Artificial Intelligence*.\n*Electronics* 14(16), 3162, 2025. https://doi.org/10.3390/electronics14163162\n\n## Links\n\n- Browser clinic (no install): https://psychopathia.ai/clinic/\n- Documentation: https://psychopathia.ai/mcp.html\n- Main project: https://psychopathia.ai/\n- Issues / contact: https://psychopathia.ai/contact/\n",
  "bytes": 8930,
  "sha": "cf81429e1b0759b6a73beac4e533ad3569e9864c75cc8d833cbf4bada4f6dc10",
  "repo_slug": "nellinc/psychopathia-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_nellinc_psychopathia_mcp_fd71de9a/readme"
}