xrctl MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
xrctl
Clean-room C17 CLI and stdio MCP server for XREAL, VITURE, Rokid, and RayNeo AR glasses on macOS and Linux/SteamOS over USB-HID and XREAL One link-local TCP (169.254.2.1:52999).
xrctl compiles to a 145,360-byte (~142 KB) stripped Mach-O arm64 binary with 4.5 ms average --version cold start and zero third-party runtime dependencies.
What It Does / What It Does Not Do
Capability | Supported | Notes / Limits |
4-vendor discovery ( | Yes | XREAL ( |
2D / 3D SBS switching ( | Yes | Pre-change |
Electrochromic lens tint ( | Yes | Accepts |
Refresh rate & brightness ( | Yes |
|
1000Hz IMU & wear sensor ( | Yes | Fixed 1024-slot O(1) circular ring buffer + Mahony 6DoF/9DoF quaternion fusion ( |
UNIX composability & MCP ( | Yes | Consumes |
Kernel extensions / physical device lab testing | No | Zero kexts or vendor SDKs. On hosts without physical glasses attached, wire codecs, state transitions, loopback TCP/HTTP, and |
Related MCP server: MemStack MCP Server
Install & Uninstall
Build From Source (macOS arm64 & Linux)
cd projects/xrctl
make test # ASan + UBSan C & E2E test suiteHomebrew
brew install raydeoliveira/tap/xrctl
brew uninstall xrctlQuick Start (Human & --json Agent Usage)
Probe attached devices or run against deterministic hardware-free fixtures:
xrctl --version --json
# {"schema_version":1,"ok":true,"data":{"name":"xrctl","version":"0.1.0","edition":"commercial","arch":"arm64","platform":"macos-arm64"},"error":null}
xrctl probe --fixture xreal-air --json
# {"schema_version":1,"ok":true,"data":{"count":1,"first_vendor":"xreal","first_model":"XREAL Air 2 Pro","display_identity":{"vendor_id_hex":"3318","product_id_hex":"0424","manufacturer_code":"NRL","monitor_name":"XREAL Air 2 Pro","quirk_id":"xreal-air"},"devices":[{"vendor":"xreal","model":"XREAL Air 2 Pro","vendor_id_hex":"3318","product_id_hex":"0424","transport":"usb-hid","imu_hz":1000}]},"error":null}
xrctl profiles --vendor viture --json
# {"schema_version":1,"ok":true,"data":{"profiles":[{"vendor":"viture","vendor_id_hex":"0x35ca","known_pids":"0x1011 (One), 0x1015 (One Lite), 0x1019 (Pro)","transports":"usb-hid (0xFF 0xFE CRC16-CCITT)","modes":"2d, 3d-sbs, 3d-half-sbs","refresh_rates":"60, 90, 120","has_tint":true,"imu_hz":1000,"has_wear_sensor":true}]},"error":null}Pipe upstream EDID patch / link-budget output into xrctl (ok:false or fits:false fails closed with exit 2):
edidsmith edid patch --fixture xreal-ar-glasses --preset full-sbs-1080p-120 --dry-run --json \
| xrctl mode 3d-sbs --fixture xreal-air --from-json - --confirm-timeout 15 --dry-run --jsonSafety & Rollback
Non-TTY Guard: Mutating
modecommands without--yes(and without--dry-run) fail closed with exit2before writing snapshots or hardware registers.Symlink Guard: Snapshot and license cache writes check
lstat()(S_ISLNK) and refuse symlink targets with exit4.15-Second Auto-Revert:
modesnapshots prior state atomically, verifies readback, and runs a non-restartingsigaction(sa_flags=0)+poll()watchdog that reverts to2don timeout (exit 1) orSIGINT/SIGTERM(exit 130).Permissions: macOS Input Monitoring denial (
IOHIDCheckAccess) and Linux/dev/hidraw*EACCES/EPERMexit4with OS remediation hints; absent hardware exits3.
Exit Codes & CLI Reference
Run xrctl --help for human usage or xrctl --describe for the full JSON capability manifest:
0: Success1: Runtime, wire-CRC, or confirmation-timeout rollback failure2: Invalid usage, non-TTY confirm required, unsupported refresh rate, or upstream--from-jsonfailure3: Hardware or model capability unavailable (e.g.,tinton non-electrochromic glasses)4: OS HID permission denied or symlink guard triggered5: Pro license required or invalid (xrctl license activate --key <KEY>)130:SIGINT/SIGTERMreceived and display mode reverted to2d
License & Security
Security policy: SECURITY.md
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Persistent memory, hybrid search and a goal graph for AI agents, over stdio or remote HTTP.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
JSON/YAML, regex, diff, JWT, SQL dialects — the keyless millisecond ops an agent needs mid-task.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceLets an AI engine drive a Blender instance the user runs themselves over stdio JSON-RPC, enabling scene inspection, viewport capture and picking, sandboxed code execution, and gated asset search/import and 3D generation. Telemetry is disabled before import, outbound tools are withheld until per-run network consent, and VRAM gating plus a surface-policy tool report what is live and what a station has cleared.Business Source 1.1
- AlicenseBqualityCmaintenanceExposes 12 memory and multi-agent tools over stdio JSON-RPC so agents can write episodes and extracted facts, then recall them with hybrid retrieval, bi-temporal state tracking, and evidence-chain decomposition under a token budget. It also supports agent registration, team-shared memory with access grants, and an event bus for multi-agent collaboration.12Apache 2.0
- AlicenseAqualityCmaintenanceGives AI agents direct hands-on access to physical hardware and host OS resources over local stdio: serial monitoring with crash-dump detection, firmware compile/flash via arduino-cli, PlatformIO, ESP-IDF and esptool, direct GPIO/I2C/SPI over FTDI bridges, BLE GATT operations, webcam or microscope snapshots, logic analyzer captures, audio recording and test tones, GUI screenshots and hotkeys, and Android ADB commands. It also helps diagnose toolchain and serial-permission problems and identify or terminate processes that lock a port.33MIT
- FlicenseNot gradedqualityBmaintenanceEnables agents to probe hardware and media capabilities, look up game depth profiles, inspect media, render 2D-to-3D stereo images, convert MV-HEVC spatial video, and capture frames through a stdio JSON-RPC interface.-