-
Notifications
You must be signed in to change notification settings - Fork 1
MCP Topology
The reverse tunnel is for tools that are only reachable from the Pi. Everything co-located with the daemon registers as a hosted HTTP MCP. Session overlays register per session; Pi-local tunnel MCP bootstrap may still be incomplete — check Progress Tracker.

home_assistant · media_audio_transcribe · media_understand · media_video_analyze · fetch_url · filesystem_local
COMSTAR attention vision runs bridge → CPAI directly, not via an AO vision MCP.
media_audio_transcribe exists but is not the COMSTAR voice STT path — that is Reach SpeechClient or env STT URL.
| MCP | Exposes |
|---|---|
client.terminal |
display, tones, mic status, sleep, volume |
client.google_workspace |
mail / calendar / Drive via off-the-shelf npm MCP |
filesystem_local |
Scoped local paths, if needed |
Tool tables: Contracts — MCP.
Too slow for the 15 s budget: web search, arxiv, long-running media analysis. Belong in batch flows (morning briefing), not conversation.

| Session | Allowed |
|---|---|
| Known userid | Voice responder MCP allowlist (may include HA, Google, terminal) |
| Guest | Restricted — no home_assistant, no Google, no client.terminal
|
COMSTAR AI — Not a mystical AI. A tool you engineered — transparent, hackable, fast.
Home · Architecture · Admin Console · Runbook · Contracts
Apache-2.0 · Pre-alpha · Raspberry Pi 4 terminal + local AI server
COMSTAR AI
Start here
Product
Build & configure
Interfaces
- Contracts Overview
- Bridge ↔ Kiosk
- Bridge ↔ Audio
- CodeProject.AI
- AO Reach
- MCP Tools
- Attention State Machine
Features
- Speech (STT/TTS)
- Vision & Face Enrollment
- Directory Identity
- Wake Word
- MCP Topology
- Terminal Control
- Google Workspace
Decisions (ADRs)
- ADR Index
- 0001 Audio Routing
- 0002 Render Path
- 0003 Speech on Ada
- 0004 Terminal Control
- 0005 LDAP Identity
- 0006 House Presence
- 0007 Full-Duplex AEC
- 0008 TTS Engine
- 0009 Proactivity
- 0010 Text Channel
- 0011 Road VPN
- 0012 Admin Network
- 0013 AO mTLS
- 0014 Fallback Hotspot
Operate
Plan
Meta