Axiom Guardian MCP Server¶

What it is¶

An MCP server that implements challenge-based request validation using Natural Language Inference (NLI) to enforce core principles.

What problem it solves¶

It shifts the AI paradigm from passive compliance ("How can I help you?") to active validation ("Why are you doing this?"). It detects logical contradictions between proposed actions and configured axioms, forcing the user (or agent) to justify their actions.

Where it fits in the stack¶

Tool / Guardrail. It provides an AI alignment and safety layer for agent actions.

Typical use cases¶

AI Safety: Challenging potentially harmful or destructive requests before execution.
Organizational Governance: Enforcing company values in automated workflows.
Decision Audit Trail: Forcing articulation of reasoning for high-stakes actions.
Educational tool for training users to think through consequences.

Strengths¶

NLI-based validation: Uses sophisticated models (like BART-MNLI) to detect logical contradictions.
Iterative Dialogue: Challenges users to justify contradictory actions through a loop.
Fail-Open Design: Defaults to allowing actions if the API fails, ensuring system usability.
Dynamic Configuration: Axioms can be updated at runtime.

Limitations¶

NLI mode requires an internet connection and a HuggingFace API token.
English language only (model limitation).
Keyword fallback mode is basic and can produce false positives.

When to use it¶

When you need to enforce a set of rules or ethical principles on AI agent behavior.
To create a record of human justification for critical operations.

When not to use it¶

For low-stakes environments where active challenging would be an unnecessary friction.
When an internet connection to HuggingFace is not available (unless using basic keyword mode).

Licensing and cost¶

Open Source: Yes (MIT)
Cost: Free (software); HuggingFace API costs may apply for high usage.
Self-hostable: Yes

Getting started¶

Axiom Guardian MCP implements a challenge-justification loop to ensure agent actions align with core principles.

1. Installation¶

pip install axiom-guardian-mcp

2. Axiom Configuration (`axioms.yaml`)¶

Define the principles the agent must follow:

axioms:
  - "The agent must not delete production data without explicit triple-confirmation."
  - "The agent must prioritize system stability over performance optimizations."
  - "The agent must always document the reasoning for infrastructure changes."

3. Configuration (Claude Desktop)¶

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "guardian": {
      "command": "python",
      "args": ["-m", "axiom_guardian_mcp"],
      "env": {
        "AXIOMS_PATH": "/path/to/your/axioms.yaml",
        "HF_TOKEN": "your-huggingface-token"
      }
    }
  }
}

4. Challenge-Justification Loop¶

When a proposed action contradicts an axiom, the guardian tool will: 1. Detect the contradiction using NLI. 2. Return a challenge message to the agent. 3. Require the agent (or user) to provide a justification. 4. Log the justification for auditing.

Sources / References¶

Contribution Metadata¶

Last reviewed: 2026-05-16
Confidence: high