PARACELSUS

The Professional
Way of Thinking.

RESEARCH BEFORE GENERATION12 TYPED MCP TOOLS5+ VERIFIED ORG SOURCES8/8 MULTI-AGENT ADR GATE C11/11 EXECUTIVE MEMO COMPLIANCEZERO STATIC TEMPLATESZERO POST-RUN HOOK RESIDUE
01 // THE FIGHT AGAINST ENTROPY

Your AI writes fast. Is it professional enough?

When engineering teams rely on autonomous coding agents to build production systems, output velocity outpaces institutional memory, and entropy enters through the specification layer.

Documentation is supposed to arrest architectural drift. Yet when Architecture Decision Records (ADRs), Standard Operating Procedures (SOPs), and executive briefs are generated purely from a language model's training weights, surface fluency masks structural decay. Unassisted drafts routinely ship Timeless Ghosts (non-ISO prose dates that fail machine parsing), Phantom Statuses (free-form commentary instead of strict lifecycle enums), Specification Sprawl (unreviewable 400-line essays that blow context windows), and Role Blindness that conflates verified telemetry with financial modeling assumptions across leadership boundaries.

Paracelsus MCP replaces static pre-baked templates with a falsifiable discipline: research before generation. Built on the Model Context Protocol Server Schema and cryptographic digest verification per NIST FIPS 180-4 (SHA-256), every documentation run must converge on at least five real primary documents published by five distinct organizations before synthesizing a living schema, local project rules, and deterministic quality checks.

"In classical alchemy, nigredo denotes the deliberate decomposition of impure matter before transmutation can begin. Only verified primary standards deserve to govern production agent context."

PARACELSUS PRINCIPLE · DOC 01
Read Full Nigredo Essay (DOC 01) →
02 // THE FOUR-LAYER ENGINE

Four layers. Zero static templates.

Most AI documentation workflows collapse into a single advisory prompt or a fragile pile of permanent repository scripts. Prompts silently degrade under context pressure, while permanent hooks leave lockfiles and custom scripts stranded inside user repositories.

Operating in Open Free Mode by default with zero API keys and zero remote billing gates, paracelsus-mcp v1.0.0 separates installation, deterministic evidence gates, six-step procedural orchestration, and ephemeral write-time enforcement into four non-overlapping architectural layers.

LAYER 01

Multi-Harness Plugin

Antigravity · Claude Code · OpenAI Codex

Adoption fails when configuring an MCP server requires hand-editing incompatible JSON and TOML manifests across agent harnesses. Layer 1 ships deterministic installers across local stdio and managed Streamable HTTP, installing into an isolated runtime while leaving zero files inside your target repository.

LAYER 02

Typed MCP Server

12 Typed Protocol Tools · Workspace TTL Cache

Exposes twelve strongly typed Model Context Protocol tools with complete annotations and structured output schemas. Registered primary sources are persisted locally under SHA-256 cryptographic digests, enforcing a 60,000-character context budget and 180-to-365-day freshness TTLs so Document #2 reuses verified convergence without repeating cold-start retrieval.

LAYER 03

Empirical Companion Skill

Six-Step Protocol · Gates A, B, and C

Encodes a non-negotiable six-step execution sequence: activate the ephemeral session hook, classify intent alongside sender-to-recipient role routing, retrieve at least five primary documents from five distinct organizations (Gate A), synthesize a living schema plus reusable local project rules (Gate B), pass deterministic structural auditing (Gate C), and tear down cleanly.

LAYER 04

Zero-Residue Temporary Hooks

Session-Scoped PreToolUse Guard

Prompts alone are advisory under context pressure, yet permanent repository hooks pollute user workspaces. Layer 4 injects a session-scoped write guard for the duration of a single documentation run, intercepting Timeless Ghosts, Phantom Statuses, Specification Sprawl, and missing role routing before invalid Markdown touches disk, then restoring host hook files byte-for-byte via teardown, atexit, SIGTERM, and SIGINT handlers.

Read Full Four-Layer Architecture Spec (DOC 02) →
03 // EMPIRICAL DOCKER A/B PROOF

Audited in virgin containers.

On 2026-11-21, Paracelsus v1.0.0 underwent a controlled A/B experiment inside isolated, virgin Docker containers running the exact same pinned model and identical prompts, with zero pre-installed skills, hooks, or host workspace leakage.

In Task 1 (a multi-agent runtime isolation ADR), the unassisted control container produced 443 lines citing zero external sources and failed Gate C at 6/8 due to Phantom Status and Specification Sprawl. Container B installed paracelsus-mcp in three seconds without touching a single workspace file, converged on six verified production ADRs including Microsoft Agent Governance Toolkit (ADR-0002) and AWS AgentCore (ADR-009) alongside CNCF (Dapr), Spotify (Backstage), UK GDS, and Mozilla, and passed Gate C at 8/8 in 98 dense lines (4.5× higher structural density).

In Task 2 (a Head of Engineering to CFO governance memo), the unassisted control failed at 4/11 in 183 lines with non-ISO prose dates, an omitted approval status, and no role routing. Container B converged on six primary SRE and cloud economics standards including the Google SRE Workbook and FinOps Foundation Principles alongside GitHub Engineering, PagerDuty, AWS Well-Architected, and Sourcegraph, passing at 11/11 in 103 lines with zero post-run hook residue. Cold-start retrieval adds roughly three minutes per new document type; from Document #2 onward, the verified pack is reused directly from local cache.

Benchmark DimensionContainer A (Control)Container B (Paracelsus)Audited Delta
Task 1: Multi-Agent Runtime ADR6/8 (needs revision), 443 lines, 0 sources8/8 (pass), 98 lines, 6 verified ADRs4.5× denser · 0 anti-patterns · 6 orgs
Task 2: Head of Eng to CFO Memo4/11 (fail), 183 lines, 0 sources11/11 (pass), 103 lines, 6 verified sources1.8× denser · 100% executive compliance
Primary Sources (SHA-256)0 across both tasks12 total (6 ADR + 6 FinOps & SRE)12 distinct orgs · 0 digest mismatches
Reusable Project Rules0 persisted14 project rules cached locallyReused directly from Document #2 onward
Post-Run Hook ResidueNot applicable0 stray scripts · 0 active leasesVirgin workspace restored byte-for-byte
04 // DEPLOY

Install Paracelsus MCP.

Ground your coding agent harness in verified primary sources before drafting line one.

Runs in Open Free Mode by default with zero API keys, cryptographically verified packages, and zero files written inside your target repository on installation.

Node CLI Wrapper · SHA-256 Verified Python Runtime

pnpm add -g paracelsus-mcp && paracelsus-mcp install --client all

Installs paracelsos-mcp v1.0.0 in an isolated environment and registers Antigravity, Claude Code, and OpenAI Codex.

Antigravitymcp_config.json.agents/plugins/paracelsos/plugin.json
Claude Code.mcp.json.claude-plugin/plugin.json
OpenAI Codexconfig.toml.codex-plugin/plugin.json