Phantom Vision VMS / Ghost Protocol

Appearance

About this article ​

  • Audience: Operators probing fleet health, MQTT cache, and MCP tools through the Phantom proxy
  • Goal: After reading, you can run the most common curl checks against PHANTOM_PROXY without opening the full API catalog
  • Type: Reference

Summary ​

Common curl probes against the phantom proxy—MCP forward, MQTT cache, and fleet health. Set PHANTOM_PROXY=https://<phantom-proxy>:8788; target shadows with <device-ip>.

Prerequisites ​

  • Phantom stack running (proxy :8788, MQTT :1883)
  • export PHANTOM_PROXY=https://<phantom-proxy>:8788
  • At least one shadow deployed per Quickstart

Fleet ​

bash
# Registry — shadows, roles, bus membership
curl -s "$PHANTOM_PROXY/fleet/registry"

# Health — recorder, storage, readiness
curl -s "$PHANTOM_PROXY/fleet/health"

# Playback-ready — justified chunks with play URLs
curl -s "$PHANTOM_PROXY/fleet/playback-ready?shadow=site-role-a&limit=5"

MQTT ​

bash
# Latest — cached telemetry, dets, status (~10 Hz)
curl -s "$PHANTOM_PROXY/fleet/mqtt/latest"

# Config — broker host, topics, ingest status
curl -s "$PHANTOM_PROXY/fleet/mqtt/config"

Tools ​

bash
# Recording status (MCP forward)
curl -s -X POST "$PHANTOM_PROXY/tools/call?target=<device-ip>" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_recording_status","arguments":{}}'

# Latest detections
curl -s -X POST "$PHANTOM_PROXY/tools/call?target=<device-ip>" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_latest_dets","arguments":{}}'

# Snapshot / pull recording
curl -s "$PHANTOM_PROXY/stream/snapshot?target=<device-ip>&w=320&q=3" -o snapshot.jpg
curl -s "$PHANTOM_PROXY/pull-recording?target=<device-ip>&which=latest"

Health ​

bash
# Proxy liveness
curl -s "$PHANTOM_PROXY/health"

# Fleet readiness — phantom module grades
curl -s "$PHANTOM_PROXY/fleet/readiness"

# Debug events ring buffer
curl -s "$PHANTOM_PROXY/debug/events"

Next steps ​

Operator depth ​

Live fleet state and harness evidence live in private operator handoff (not published) (private).