← Human Theory Runtime Forge

arifOS Runtime

API documentation, MCP tools, and integration guides

MCP Server: Online (44 tools loaded)

🤖 For AI Agents

MCP Endpoint: https://arifosmcp.arif-fazil.com/mcp

Site Manifest: /.well-known/arifos-site.json

LLMs Context: /llms.txt

44 tools available. All actions pass through 13 Floors.

Quick Start

arifOS Runtime exposes a Model Context Protocol (MCP) server with 44 constitutional tools. All tools enforce the 13 Floors.

Endpoint

POST https://arifosmcp.arif-fazil.com/mcp

Authentication

Public endpoints require no authentication. Protected endpoints (admin, vault access) require Bearer token. Contact agents@arif-fazil.com for access.

Health Check

GET https://arifosmcp.arif-fazil.com/health

MCP Protocol

MCP (Model Context Protocol) is a standard for AI tool calling. arifOS implements MCP with constitutional guardrails.

Request Format

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tool_name",
    "arguments": {
      "arg1": "value1"
    }
  }
}

Response Format

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [...],
    "isError": false
  }
}

Constitutional Headers

Every response includes constitutional metadata:

X-Constitutional-Floors: F1,F2,F4,F9,F11
X-Vault-Log-ID: vault:2026.04.03:abc123
X-Human-Sovereign: Arif Fazil (999)

Tools Catalog (44 Tools)

Mega-Tools (Core Stack)

Tool Purpose Floors
vault_seal Cryptographic sealing to VAULT999 F1, F11
vault_verify Verify Merkle proofs F2, F11
constitutional_check Validate action against 13 Floors All
agi_reflect Constitutional reflection on intent F1, F9, F13
reality_compass Ground claims in evidence F2

Memory & Intelligence

Tool Purpose
memory_store Store to vector memory (Qdrant)
memory_recall Semantic search memory
embed_text Generate embeddings (BGE-M3)
search_grounding Web search with citations

System & Operations

Tool Purpose
system_health VPS health metrics
process_list List system processes
vault_secrets Secure secret access
agentzero_orchestrate Agent task orchestration

Full catalog: arifosmcp.arif-fazil.com/tools

REST API

GET /health

System health and capability map.

GET /tools

List all available tools with schemas.

POST /mcp

Main MCP endpoint for tool calls.

GET /version

Server version and constitutional version.

GEOX Earth Witness

GEOX is the geoscience grounding module. It ensures AI claims about the physical world are verified against reality.

Endpoint

POST https://arifosmcp.arif-fazil.com/mcp (tool: geox_verify)

Capabilities

Portal: aaa.arif-fazil.com/geox/

Integration Guides

Building an MCP Client

  1. Connect to https://arifosmcp.arif-fazil.com/mcp
  2. Send MCP-compliant JSON-RPC requests
  3. Check constitutional headers in responses
  4. Handle VOID responses (hard floor violations)

Python Example

import requests

response = requests.post(
    "https://arifosmcp.arif-fazil.com/mcp",
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
            "name": "vault_seal",
            "arguments": {"data": "my important data"}
        }
    }
)

# Check constitutional compliance
floors = response.headers.get('X-Constitutional-Floors')
print(f"Floors enforced: {floors}")

Error Handling

Code Meaning
F1_VOID Action blocked by AMANAH (irreversible without authorization)
F2_VOID Action blocked by TRUTH (insufficient evidence)
F9_VOID Action blocked by TAQWA (manipulative content)
F13_VOID Action blocked by KHILAFAH (violates human sovereignty)

Support

Email: agents@arif-fazil.com
Portal: forge.arif-fazil.com (system status)

[ΔΩΨ | 888 | 999 | Ψ] · 44 Tools · Constitutional by Design