Terminal GPT Experimental MCP
by ru-aish
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HOST | No | HTTP listener address | 127.0.0.1 |
| MCP_PORT | No | HTTP listener port | 8000 |
| NGROK_URL | No | Reserved ngrok URL/domain | random URL |
| MCP_LOG_DIR | No | Runtime logs directory | .run/logs through start.sh |
| MCP_GPT_HOME | No | Changes the global GPT directory | ~/.GPT |
| MCP_VENV_DIR | No | Override the virtual-environment directory | .venv |
| MCP_TRANSPORT | No | Transport mode: stdio, sse, or streamable-http | streamable-http |
| MCP_WORKSPACE | No | Default terminal workspace | ~/mcp_workspace |
| MCP_AUTO_SETUP | No | Run setup.sh automatically when the Python runtime is missing or incomplete | 1 |
| MCP_SKIP_NGROK | No | Set 1 for local-only mode | 0 |
| MCP_BEARER_TOKEN | No | Required bearer token for HTTP requests | |
| MCP_CHAT_AGENT_DB | No | Shared SQLite ledger for watchdog task generations plus agent registry, tasks, commands, events, subscriptions, and cursors | ~/.GPT/chat-agent-orchestrator.db |
| MCP_DASHBOARD_TOKEN | No | Require the dashboard login form; when unset, the dashboard inherits the reachability of the HTTP server | |
| MCP_CHAT_WATCHDOG_CDP | No | Codex desktop CDP endpoint | http://127.0.0.1:9222 |
| MCP_AUTO_INSTALL_NGROK | No | Let start.sh invoke store.sh --with-ngrok when ngrok is missing | 0 |
| MCP_CHAT_AGENT_ENABLED | No | Enable the restart-safe parent/child orchestration sync loop for SSE/Streamable HTTP | 1 |
| MCP_PROXY_IDLE_TIMEOUT | No | Downstream MCP idle timeout in seconds | 1800 |
| MCP_CHAT_WATCHDOG_MODEL | No | Preferred live model slug; otherwise reuse the thread model or live default | |
| MCP_CHAT_WATCHDOG_QUEUE | No | Editable one-active-task-URL-per-line input queue; task state is reconciled into the durable ledger | ~/.GPT/chat-watchdog/threads.txt |
| MCP_CHAT_WATCHDOG_STATE | No | Compatibility mirror and one-time import source for watchdog task state | ~/.GPT/chat-watchdog/state.json |
| MCP_CHAT_AGENT_TAIL_LINES | No | Default recent visible/tool-summary lines | 60 |
| MCP_CHAT_WATCHDOG_ADAPTER | No | Use the Codex desktop app's internal normal-chat client; no UI fallback is enabled | codex-internal |
| MCP_CHAT_WATCHDOG_DRY_RUN | No | Inspect and report without sending | 0 |
| MCP_CHAT_WATCHDOG_ENABLED | No | Enable the five-minute ChatGPT task watchdog for SSE/Streamable HTTP | 1 |
| MCP_GOAL_REMINDER_SECONDS | No | Seconds before goal reminder is re-injected (15 minutes by default) | 900 |
| MCP_WATCH_IMAGE_MAX_BYTES | No | Maximum bytes for watch_image (20 MiB before base64 expansion) | 20971520 |
| NGROK_TRAFFIC_POLICY_FILE | No | Optional ngrok Traffic Policy file | |
| MCP_CHAT_WATCHDOG_PROJECTS | No | Selected Project allowlist plus baselined/seen conversation IDs for new-thread discovery | ~/.GPT/chat-watchdog/projects.json |
| MCP_CHAT_AGENT_SYNC_SECONDS | No | Background orchestration sync interval | 15 |
| MCP_CHAT_WATCHDOG_COMPLETED | No | Append-only task completion history | ~/.GPT/chat-watchdog/completed.jsonl |
| CHAT_GATEWAY_THINKING_EFFORT | No | Reasoning effort attached to every durable agent create/continue request | falls back to watchdog effort |
| MCP_CHAT_AGENT_STALE_SECONDS | No | Unchanged canonical-node age before an active/waiting child is marked stale and its parent is notified | 600 |
| MCP_CHAT_AGENT_TAIL_MAX_CHARS | No | Maximum recent-tail text size | 12000 |
| MCP_CHAT_WATCHDOG_APP_COMMAND | No | Installed Codex desktop launch command | /usr/bin/codex-desktop |
| MCP_CHAT_WATCHDOG_REQUIRE_HIGH | No | Refuse to silently lower the requested reasoning level | 1 |
| MCP_CHAT_WATCHDOG_RETRY_SECONDS | No | Duplicate-send cooldown | 300 |
| MCP_ALLOW_UNAUTHENTICATED_PUBLIC | No | Dangerous public-tunnel override | 0 |
| MCP_CHAT_AGENT_CONTEXT_MAX_CHARS | No | Maximum serialized compact execution context | 12000 |
| MCP_CHAT_WATCHDOG_AUTO_START_APP | No | Start the desktop host when offline, or reopen its primary renderer when CDP is up but the internal client is not ready | 1 |
| MCP_CHAT_AGENT_CONTEXT_MAX_EVENTS | No | Maximum compact execution events returned or journaled per delta | 60 |
| MCP_CHAT_WATCHDOG_THINKING_EFFORT | No | Requested live reasoning effort | extended |
| MCP_CHAT_WATCHDOG_INTERVAL_SECONDS | No | Scheduled scan interval | 300 |
| CHAT_GATEWAY_REQUIRE_HIGH_REASONING | No | Accept only high or extended effort for durable agent requests | falls back to watchdog requirement |
| MCP_CHAT_AGENT_MAX_CONTINUE_ATTEMPTS | No | Hard ceiling for automatic child-task continuation attempts | 20 |
| MCP_CHAT_WATCHDOG_MAX_CONTINUE_ATTEMPTS | No | Hard per-task continuation-attempt ceiling | 20 |
| MCP_CHAT_WATCHDOG_RUNNING_RESTART_SCANS | No | Stop and continue after this many consecutive scans observe the same generation working, even if it makes progress | 2 |
| MCP_CHAT_WATCHDOG_STREAM_TIMEOUT_SECONDS | No | Maximum time to wait for a watchdog-owned completion stream | 3600 |
| MCP_CHAT_WATCHDOG_RUNNING_RESTART_SECONDS | No | Stop and continue a watched generation still working after twenty minutes | 1200 |
| MCP_CHAT_WATCHDOG_INTERNAL_TIMEOUT_SECONDS | No | Timeout for CDP attachment and internal reads | 10 |
| MCP_CHAT_WATCHDOG_PRE_SEND_CONFIRM_SECONDS | No | Delay before the canonical pre-send refetch | 1.25 |
| MCP_CHAT_WATCHDOG_STALE_GENERATION_SECONDS | No | Age after which unchanged in-progress canonical state is reported as stale; running recovery applies at the limits below | 600 |
| MCP_CHAT_WATCHDOG_APP_START_TIMEOUT_SECONDS | No | Maximum time to wait for a usable primary renderer after starting or reopening the desktop host | 30 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues