Model Context Protocol

Your AI agent just got
a terminal.

20 tools. Unix socket. Zero config. Chau7 exposes every tab, command, and session to any MCP-compatible AI agent.

How it works

Three steps from launch to full terminal control.

1

Launch Chau7

On startup, Chau7 auto-registers its MCP server in Claude Code, Cursor, Windsurf, and Codex config files.

2

AI connects via MCP

Your AI agent discovers the Unix socket and calls tools like tab_create, tab_exec, and tab_output.

3

Full terminal control

Create tabs, run commands, read output, inspect processes, track sessions. No hacks, no screen scraping.

20 tools. Everything exposed.

Full terminal lifecycle control and AI telemetry, accessible through the standard MCP protocol.

Tab Management (8 tools)

tab_listList all tabs across windows with status, git branch, CTO state
tab_createOpen new tabs with directory & window targeting
tab_execExecute commands with prompt-state checking
tab_statusProcess tree, telemetry run, git branch, CTO state
tab_send_inputRaw input for interactive prompts (no newline appended)
tab_closeClose with optional force flag for running processes
tab_outputLast N lines of scrollback (max 5000, 512KB cap)
tab_set_ctoPer-tab Context Token Optimization override

Telemetry & Analytics (8 tools)

run_getFull telemetry run by UUID
run_listFilter by session, repo, provider, date range, tags
run_tool_callsEvery tool call an AI agent made in a run
run_transcriptComplete conversation turns for replay
run_tagTag runs for organization and filtering
run_latest_for_repoMost recent run per repository path
session_listSessions with run counts, filterable by repo
session_currentCurrently active AI sessions across all tabs

MCP Resources (4 endpoints)

tab://listAll open tabs with metadata
session://listActive AI sessions
run://latestMost recent telemetry run
config://mcpCurrent MCP server configuration
tab_status response
{
  "tab_id": "C1C4AB49-DA22-46F6-831B-FF7CFC2BDDC3",
  "active_app": "Claude",
  "status": "running",
  "git_branch": "main",
  "cto_active": true,
  "is_mcp_controlled": false,
  "processes": [
    { "name": "claude", "pid": 48291, "cpu_percent": 12.3 }
  ],
  "active_run": {
    "provider": "claude",
    "duration_so_far_ms": 184200
  }
}
run_tool_calls response
{
  "run_id": "a3f8c2e1-9b4d-4f6a-8e7c-5d2b1a0f3e9d",
  "tool_calls": [
    {
      "tool": "Read",
      "input": { "file_path": "/src/main.swift" },
      "duration_ms": 45
    },
    {
      "tool": "Edit",
      "input": { "file_path": "/src/main.swift" },
      "duration_ms": 120
    }
  ]
}

Zero-config auto-registration

On every launch, Chau7 registers itself in your AI tools' MCP config files. No manual setup.

Claude Code~/.claude.json
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
Codex~/.codex/config.toml

You control what agents can do.

MCP access is powerful, and fully controllable.

Approval Gate

MCP tool calls can require explicit user approval before executing. Enable per-tool or globally.

Tab Limits

Set maximum number of MCP-created tabs to prevent runaway agents from spawning unlimited sessions.

Enable / Disable Toggle

Turn MCP server on or off entirely from Settings. When off, the Unix socket is not created.

MCP Tab Indicator

Tabs created by MCP are visually tagged so you always know which tabs an AI agent opened.

Frequently asked questions

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI agents interact with external tools and data sources. Chau7 implements an MCP server that exposes terminal control as 20 tools over a Unix socket. Learn more about MCP.

Which AI tools work with Chau7's MCP?

Claude Code, Cursor, Windsurf, and Codex auto-discover Chau7's MCP server on launch. Any MCP-compatible client can connect via the Unix socket at the path specified in the config files.

Is MCP access safe?

Yes. Chau7 provides an approval gate for MCP actions, configurable tab limits, a global enable/disable toggle, and visual indicators for MCP-created tabs. You always know what an agent is doing, and you control what it can do.

Do I need to configure anything?

No. Chau7 auto-registers its MCP server in Claude Code (~/.claude.json), Cursor (~/.cursor/mcp.json), Windsurf (~/.codeium/windsurf/mcp_config.json), and Codex (~/.codex/config.toml) on every launch. Zero manual setup required.