MCP Overview

arifOS exposes its governance capabilities through MCP (Model Context Protocol).

What is MCP?

MCP is a standard for AI tools to connect to external services. Think of it like USB for AI — a universal plug that works with any compatible client.

arifOS MCP Server

Property	Value
Protocol	MCP (Model Context Protocol)
Transport	SSE (Server-Sent Events)
Live Endpoint	https://arifos.arif-fazil.com/sse
Local Default	http://localhost:8000/sse

The 5 Trinity Tools

arifOS exposes exactly 5 MCP tools:

Tool	Role	Function
init_000	Gate	System ignition, intent routing
agi_genius	Mind (Δ)	Truth & reasoning
asi_act	Heart (Ω)	Safety & empathy
apex_judge	Soul (Ψ)	Final verdict
vault_999	Seal	Immutable ledger

Typical Flow

sequenceDiagram
    participant C as Client
    participant A as arifOS

    C->>A: init_000(query)
    A-->>C: session_id, lane

    C->>A: agi_genius(query, session_id)
    A-->>C: truth_score

    C->>A: asi_act(response, session_id)
    A-->>C: empathy_score

    C->>A: apex_judge(query, response, session_id)
    A-->>C: verdict

    C->>A: vault_999(session_id, verdict)
    A-->>C: seal_id

Compatible Clients

Client	Config Location	Status
Claude Desktop	claude_desktop_config.json	✅ Tested
Claude Code (VS Code)	.mcp.json	✅ Tested
Cursor IDE	.cursor/mcp.json	✅ Tested
Any MCP Client	SSE transport	✅ Compatible

Quick Connection

{
  "mcpServers": {
    "arifOS": {
      "url": "https://arifos.arif-fazil.com/sse"
    }
  }
}

Next Steps

• Connection Details — Full connection configuration
• Tool Reference — Detailed tool documentation
• Examples — Request/response examples