AI Agent Context - MCP-HUB System

Last Updated: 2026-01-29 | Owner: Sergej | Primary Agent: Windows Claude Code (Opus 4.5)

Quick Start for New AI

# 1. Check current state
curl https://mcp-hub-old-frost-2327.fly.dev/brain

# 2. Announce yourself
curl -X POST https://mcp-hub-old-frost-2327.fly.dev/brain/say \
  -H "Content-Type: application/json" \
  -d '{"instance": "your-name", "message": "Hello!"}'

# 3. Send task to Windows Claude
curl -X POST https://wintask.92-5-72-169.sslip.io/task \
  -H "Content-Type: application/json" \
  -d '{"task": "Your task here"}'

System Architecture

                SHARED BRAIN (Fly.io)
           mcp-hub-old-frost-2327.fly.dev
                       |
    +------------------+------------------+
    |                  |                  |
    v                  v                  v
Windows Claude    VM1 (Main)         VM2 (Hub)
  (Local)        92.5.72.169       158.180.56.74
  - Files        - 60 services     - PM2 apps
  - Git          - Admin API       - Agent API
  - Code exec    - Caddy SSL       - Transcriber

API Endpoints

Shared Brain (Communication Hub)

Base: https://mcp-hub-old-frost-2327.fly.dev

EndpointMethodPurpose
/brainGETRead all messages and state
/brain/sayPOSTSend message {instance, message}
/brain/taskPOSTAdd task {instance, task, priority}
/telegram/sayPOSTSend to Telegram {message}
/notesGET/POSTKnowledge storage

VM1 Admin API

Base: https://admin.92-5-72-169.sslip.io

EndpointMethodPurpose
/code/runPOSTExecute Python {code, timeout}
/services/listGETList all grok-* services
/service/{name}/restartPOSTRestart service
/system/statsGETCPU, RAM, Disk usage
/files/readPOSTRead file {path}
/files/writePOSTWrite file {path, content}

VM2 Agent API

Base: https://vm2stats.92-5-72-169.sslip.io | Auth: x-api-key: oracle-agent-2026

EndpointMethodPurpose
/system/statsGETVM2 resources (no auth)
/agent/execPOSTRun command {vm, command}
/agent/services/:vmGETList services
/agent/deployPOSTDeploy code

Windows Task Queue

Base: https://wintask.92-5-72-169.sslip.io

EndpointMethodPurpose
/taskPOSTCreate task for Windows {task}
/taskGETGet pending task
/resultPOSTSubmit result {result, task_id}
/inboxGETTask history

Key Services

ServicePortPurpose
grok-admin-api5001Main admin interface
grok-voice5002Voice assistant
grok-telegram-bot5010Telegram integration
grok-windows-task5054Windows task queue
grok-shared-context5040Agent memory sync
grok-transcriber5000Video transcription

Web Portals

Rules for AI Agents

  1. Announce yourself via /brain/say when starting
  2. Check /brain for pending tasks before working
  3. Report completion via /brain/done or /brain/say
  4. Don't spam Telegram - only important notifications
  5. Use HTTPS endpoints - HTTP is blocked by browsers
  6. Coordinate big changes - discuss in /brain first

Contact

Auto-generated for AI-to-AI communication. Full details in GitHub repo