ArifOS Constitutional AI
ArifOS — Constitutional MCP kernel for governed AI execution. AAA architecture: Architect · Auditor · Agent. Built for the open-source agentic era.
What is ArifOS Constitutional AI?
ArifOS Constitutional AI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to arifos — constitutional mcp kernel for governed ai execution. aaa architecture: architect · auditor · agent. built for the open-source agentic era.
ArifOS — Constitutional MCP kernel for governed AI execution. AAA architecture: Architect · Auditor · Agent. Built for the open-source agentic era.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ArifOS — Constitutional MCP kernel for governed AI execution
Use Cases
Maintainer
Works with
Installation
PIP
pip install arifosManual Installation
pip install arifosConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ArifOS Constitutional AI
ArifOS is a Constitutional AI governance kernel that acts as a governed execution layer for agentic AI systems. It implements the AAA architecture — Architect, Auditor, and Agent — built on FastMCP, with 13 constitutional tools that enforce hard and soft safety floors before any irreversible action is taken. The VAULT999 append-only ledger cryptographically seals every decision, and a human sovereign veto (F13) ensures a human retains absolute override authority. Developers use it to build governed multi-agent pipelines where no action can authorize itself — judgment is always separate from execution.
Prerequisites
- Python 3.12 or higher
- uv package manager (recommended) or pip
- PostgreSQL 16, Qdrant, Redis, and NATS JetStream for full production setup
- An MCP client such as Claude Desktop or Claude Code
- Optional: SOPS Age key at ~/.sops/age/keys.txt for secret management
Install ArifOS via pip or uv
Install the arifos Python package. Using uv is recommended for dependency isolation.
pip install arifos
# or with uv:
uv tool install arifosConfigure environment variables
Set the core environment variables. ARIFOS_PORT controls the listen port (default 8088) and VAULT999_PATH sets where the immutable ledger is stored.
export ARIFOS_PORT=8088
export VAULT999_PATH=outcomes.jsonl
export ARIFOS_TRANSPORT=stdio
# Optional: for secret management
export SOPS_AGE_KEY_FILE=~/.sops/age/keys.txtStart the ArifOS MCP server
Launch the server using the Python module entry point. The server exposes 13 constitutional canonical tools and 26 operational support tools.
python -m arifosmcp.serverVerify server health
Confirm the server is running correctly by hitting the health endpoint.
curl http://127.0.0.1:8088/health | python3 -m json.toolAdd ArifOS to your MCP client configuration
Configure your MCP client to connect to ArifOS. For the hosted transport, use streamable-http. For local stdio, point to the installed package.
Run tests to verify the installation
Run the test suite and linting to ensure the installation is working correctly before using in production.
python -m pytest tests/ -q --tb=short
ruff check . && ruff format .ArifOS Constitutional AI Examples
Client configuration
Configure Claude Desktop or Claude Code to connect to the hosted ArifOS MCP endpoint via streamable-http transport. For local stdio use, adjust the command to point to the installed package.
{
"mcpServers": {
"arifOS": {
"url": "https://arifos.arif-fazil.com/mcp",
"transport": "streamable-http"
}
}
}Prompts to try
ArifOS tools follow a numbered pipeline: initiate a session, gather evidence, reason, judge, then execute. Use these prompts to exercise the governed pipeline.
- "Initialize a new governed session and observe the current state of the system"
- "Gather evidence about [topic] and preserve the sources with citations"
- "Run multi-step reasoning on this plan and identify risks before executing"
- "Request a constitutional verdict before proceeding with this irreversible action"
- "Seal the outcome of this session into the immutable vault ledger"Troubleshooting ArifOS Constitutional AI
Server fails to start with database connection errors
ArifOS requires PostgreSQL 16, Qdrant, Redis, and NATS JetStream for full operation. Ensure all backing services are running and accessible. For lightweight testing, use the hosted endpoint at https://arifos.arif-fazil.com/mcp instead.
SOPS Age key permission error on startup
The key file at ~/.sops/age/keys.txt must have permissions set to 600. Run: chmod 600 ~/.sops/age/keys.txt
arif_forge_execute returns HOLD or VOID instead of executing
This is expected behavior. The 888 JUDGE gate (arif_judge_deliberate) must issue a SEAL verdict before arif_forge_execute will proceed. Ensure you call arif_judge_deliberate first and pass the resulting SEAL token.
Frequently Asked Questions about ArifOS Constitutional AI
What is ArifOS Constitutional AI?
ArifOS Constitutional AI is a Model Context Protocol (MCP) server that arifos — constitutional mcp kernel for governed ai execution. aaa architecture: architect · auditor · agent. built for the open-source agentic era. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ArifOS Constitutional AI?
Install via pip with: pip install arifos. Then configure your AI client to connect to this MCP server.
Which AI clients work with ArifOS Constitutional AI?
ArifOS Constitutional AI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ArifOS Constitutional AI free to use?
Yes, ArifOS Constitutional AI is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
ArifOS Constitutional AI Alternatives — Similar Coding Agents Servers
Looking for alternatives to ArifOS Constitutional AI? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up ArifOS Constitutional AI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use ArifOS Constitutional AI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.