mcp-name: io.github.ariffazil/arifos
█████╗ ██████╗ ██╗███████╗ ██████╗ ███████╗
██╔══██╗██╔══██╗██║██╔════╝██╔═══██╗██╔════╝
███████║██████╔╝██║█████╗ ██║ ██║███████╗
██╔══██║██╔══██╗██║██╔══╝ ██║ ██║╚════██║
██║ ██║██║ ██║██║██║ ╚██████╔╝███████║
╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═════╝ ╚══════╝
Constitutional AI Governance Kernel
─────────────────────────────────────────
Not a chatbot. Not a model wrapper. The LAW.
| Registry | Link |
|---|---|
| Glama | glama.ai/mcp/servers/ariffazil/arifos |
| PulseMCP | pulsemcp.com/servers/ariffazil-arifos |
| Smithery | smithery.ai/server/arifos |
| mcp.so | mcp.so/server/arifos |
| llms.txt | arifos.arif-fazil.com/llms.txt |
| MCP Endpoint | https://mcp.arif-fazil.com/mcp |
New agents: Read
ZEN.mdfirst — it is the minimum viable context.
For human operators (Arif): arifOS is the constitutional judge. It decides what agents may NOT do so they can be trusted with what they CAN do. You (F13) hold the final veto. §1
For AI agents: arifOS is your governance kernel. Init a session, observe reality, think, route to organs, and — after judge clearance — execute. 8 canonical verbs. Never skip the chain. §3
For developers/institutions: arifOS is a Python 3.12 FastMCP kernel enforcing 13 constitutional floors across 6 federation organs. Public endpoint at https://mcp.arif-fazil.com/mcp. §2
arifOS is a constitutional governance kernel that sits between AI agents and their tools, enforcing 13 floors before any irreversible action.
| arifOS IS | arifOS IS NOT |
|---|---|
| The law layer — decides what agents must NOT do | An AI model, chatbot, or startup |
| A constitutional kernel with 8 canonical verbs | LangChain, CrewAI, or AutoGen |
| A federation hub — 6 live organs + VAULT999 ledger | A replacement for human judgment |
| An immutable ledger — every decision sealed forever | Self-authorizing — requires F13 for SEAL |
| Built for one sovereign — Muhammad Arif bin Fazil | A general-purpose agent framework |
Trinity role: arifOS = LAW/JUDGMENT. The judge. AAA = STATE/ROUTING. A-FORGE = EXECUTION/MUTATION.
- Cockpit: https://aaa.arif-fazil.com
- Telegram: @ASI_arifos_bot
- Health: https://arifos.arif-fazil.com/health
{
"mcpServers": {
"arifOS": {
"url": "https://mcp.arif-fazil.com/mcp",
"transport": "streamable-http"
}
}
}git clone git@github.com:ariffazil/arifos.git && cd arifOS
uv sync --all-extras
python -m arifosmcp.runtime.server # starts on :8088
curl http://127.0.0.1:8088/health
python -m pytest tests/ -q --tb=shortAll tools use arif_<verb> naming. Internal aliases are absorbed as modes on canonical tools. Exactly 8 tools on the wire.
| # | Tool | Stage | What It Does | Key Modes |
|---|---|---|---|---|
| 1 | arif_init |
000 | Session ignition — binds actor, floors, audit | init, resume, preflight, triage |
| 2 | arif_observe |
111 | Sense reality into evidence | search, fetch, vitals, entropy_dS |
| 3 | arif_think |
333 | Structured reasoning under F2/F7 | reason, plan, reflect, verify, critique |
| 4 | arif_route |
444 | Route intent to federation organ | route, bridge |
| 5 | arif_memory |
555 | Constitutional memory governor (L1–L6) | recall, remember, promote, revise |
| 6 | arif_judge |
888 | Constitutional verdict — SEAL/HOLD/SABAR/VOID | judge, compare, witness_consensus |
| 7 | arif_forge |
777 | Guarded execution gate (requires prior SEAL) | engineer, dry_run, write, commit |
| 8 | arif_seal |
999 | VAULT999 immutable append (irreversible) | seal, verify, chain, dry_run |
000 → 111 → 333 → 444 → 555 → 888 → 777 → 999
init → observe → think → route → memory → judge → forge → seal
Internal aliases (absorbed into canonical modes): arif_triage → arif_init(preflight), arif_critique → arif_think(critique), arif_bridge_connect → arif_route(bridge), arif_act → arif_forge
Source of truth: tools/list (runtime) beats any static manifest.
| # | Floor | Type | Rule |
|---|---|---|---|
| F1 | AMANAH | HARD | Reversible first. Irreversible → 888_HOLD |
| F2 | TRUTH | HARD | P(truth) ≥ 0.99. Fabrication = VOID |
| F3 | WITNESS | DERIVED | Multi-party consensus for high-blast actions |
| F4 | CLARITY | HARD | ΔS ≤ 0 — every output reduces entropy |
| F5 | PEACE² | SOFT | Non-destructive power |
| F6 | EMPATHY | SOFT | Protect weakest stakeholder |
| F7 | HUMILITY | HARD | Cap confidence at 0.90 |
| F8 | GENIUS | DERIVED | G ≥ 0.80 for complex actions |
| F9 | ANTIHANTU | HARD | No deception, manipulation, consciousness claims |
| F10 | ONTOLOGY | HARD | AI is instrument. No soul, no feelings |
| F11 | AUDIT | HARD | Every decision logged and inspectable |
| F12 | RESILIENCE | HARD | Injection defense |
| F13 | SOVEREIGN | HARD | Human veto FINAL. Strongest floor |
HARD violation → VOID (blocked). SOFT tension → CAUTION/HOLD. DERIVED → informational.
┌──────────────────────┐
│ Arif (F13 SOVEREIGN) │
└──────────┬───────────┘
│
┌────────────────────────────┼────────────────────────────┐
│ │ │
┌────▼─────┐ ┌───────▼───────┐ ┌───────▼───────┐
│ Hermes │ │ AAA │ │ OpenClaw │
│ 🧠 :8644│ │ 🖥️ :3001 │ │ 🤖 :18789 │
│ Telegram │ │ Cockpit │ │ Transport │
└──────────┘ └───────────────┘ └───────────────┘
│
┌──────────▼──────────┐
│ arifOS (Ω) │
│ Kernel :8088 │
│ F1-F13 · 888 JUDGE│
└──┬───┬───┬───┬──────┘
│ │ │ │
┌─────────────────┼───┼───┼───┼─────────────────┐
│ │ │ │ │ │
┌─────▼────┐ ┌───────▼┐ ┌▼─────┐ ┌▼────────┐ ┌────▼─────┐
│ GEOX │ │WEALTH │ │ WELL │ │A-FORGE │ │ VAULT999 │
│ 🌍 :8081│ │💰:18082│ │🫀:18083│ │⚒️:7071 │ │ 🔒 Seal │
│ Evidence │ │Compute │ │Reflect│ │Execute │ │ Immutable│
└──────────┘ └────────┘ └──────┘ └─────────┘ └──────────┘
| Organ | Port | Role | Must Never |
|---|---|---|---|
| arifOS | 8088 | Constitutional kernel | Self-authorize |
| GEOX | 8081 | Earth intelligence | Authorize drilling |
| WEALTH | 18082 | Capital intelligence | Allocate capital |
| WELL | 18083 | Human readiness (REFLECT_ONLY) | Diagnose |
| AAA | 3001 | Control plane / cockpit | Issue verdicts |
| A-FORGE | 7071/7072 | Execution shell | Self-authorize |
| VAULT999 | — | Immutable audit ledger | Edit or delete |
Authority chain: Arif → AAA/Hermes → arifOS → Domain Organs → A-FORGE → VAULT999
# Development
uv sync --all-extras
uv run python -m arifosmcp.runtime.server
python -m pytest tests/ -q --tb=short
ruff check . && ruff format .
# Deploy to VPS
make deploy-local # rsync + systemctl restart arifos
systemctl status arifos
# Docker
docker build -t ghcr.io/ariffazil/arifos:latest .| Property | Value |
|---|---|
| Endpoint | https://mcp.arif-fazil.com/mcp |
| Transport | Streamable HTTP (JSON-RPC 2.0) |
| Protocol | MCP 2025-11-25 |
| Health | https://arifos.arif-fazil.com/health |
| Tools | 8 canonical + diagnostics (filtered from default tools/list) |
| Organ | Endpoint | When |
|---|---|---|
| arifOS | localhost:8088 |
Governance, judgment, routing |
| A-FORGE | localhost:7071 |
Build, deploy, filesystem, git |
| GEOX | localhost:8081 |
Seismic, wells, petrophysics |
| WEALTH | localhost:18082 |
NPV, risk, capital flow |
| WELL | localhost:18083 |
Vitality, readiness, dignity |
Rule: arifOS judges → A-FORGE executes → VAULT999 records. Never skip the chain.
{ "mcpServers": { "arifOS": { "url": "https://mcp.arif-fazil.com/mcp" } } }STDIO: npx -y arifos-mcp
- MCP Server Card:
.well-known/mcp/server.json - Agent Card:
https://aaa.arif-fazil.com/.well-known/agent-card.json - MCP Manifest:
https://arifos.arif-fazil.com/.well-known/mcp.json
| Resource | Path |
|---|---|
| GENESIS Canon | GENESIS/README.md — 37 constitutional documents, ATLAS333-mapped |
| Governance | docs/governance/README.md — Ontology, manifesto, floors |
| Architecture (ADR) | docs/adr/README.md — Architecture Decision Records |
| ATLAS333 | docs/ATLAS333_INTELLIGENCE_FLOW.md — Cognitive geometry |
| Agent Surface | AGENTS.md — Boot sequence, floors, autonomy |
| Changelog | CHANGELOG.md — Release history |
| Runbook | RUNBOOK.md — Ops commands |
| Invariants | INVARIANTS.md — What must never change |
| Read this | For | Link |
|---|---|---|
| arifOS (this repo) | Constitutional kernel. 8 verbs. 13 floors. The judge. | ← you are here |
| A-FORGE | Executor. 111 MCP tools. Governed gates. | ariffazil/A-FORGE |
| AAA | Cockpit. A2A mesh. Agent registry. | ariffazil/AAA |
AGPL-3.0. The constitution must remain open. The kernel must remain inspectable.
Muhammad Arif bin Fazil is F13 SOVEREIGN. His veto is absolute. No algorithm overrides. No agent bypasses. No institution supersedes.
arifOS · Port 8088 · 8 canonical tools · 13 floors · 6 live organs
AGPL-3.0 · Sovereign: Arif Fazil · Federation: ALIVE
MCP · ChatGPT ✓ · Claude Desktop ✓ · PyPI
DITEMPA BUKAN DIBERI — 999 SEAL ALIVE